gupnp_device_action_callback_set - Set device callback function
Вернуться к: Gupnp Функции
gupnp_device_action_callback_set
(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Set device callback function
Описание
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] )Set device callback function for signal and action.
Список параметров
-
root_device
-
A root device identifier, returned by gupnp_root_device_new().
-
signal
-
The value of signal. Signal can be one of the following values:
-
GUPNP_SIGNAL_ACTION_INVOKED
- Emitted whenever an action is invoked. Handler should process action and must call either gupnp_service_action_return() or gupnp_service_action_return_error().
-
GUPNP_SIGNAL_NOTIFY_FAILED
- Emitted whenever notification of a client fails.
-
-
action_name
-
The name of action.
-
callback
-
The callback function for the certain signal. Typically, callback function takes on three parameters. The
service
parameter's identifier being the first,action
parameter's identifier (in case GUPNP_SIGNAL_ACTION_INVOKED signal) orerror
parameter's message (in case GUPNP_SIGNAL_NOTIFY_FAILED signal) being the second, and thearg
is third. -
arg
-
User data for
callback
.
Возвращаемые значения
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
Ошибки
Issues E_WARNING either with not valid callback function or with not valid signal.
Вернуться к: Gupnp Функции