gupnp_device_action_callback_set

(PECL gupnp >= 0.1.0)

gupnp_device_action_callback_set — Establece una función callback a un dispositivo

Descripción

bool gupnp_device_action_callback_set ( resource $root_device , int $signal , string $action_name , mixed $callback [, mixed $arg ] )

Establece una función callback para una señal y acción.

Parámetros

root_device

Un identificador de dispositivo raíz, devuelto por gupnp_root_device_new().

signal

El valor de la señal. La señal puede ser uno de los siguientes valores:

GUPNP_SIGNAL_ACTION_INVOKED: Emitida siempre que una acción es invoada. El manejador debería procesar la acción y debe llamar a cualquier gupnp_service_action_return() o gupnp_service_action_return_error().
GUPNP_SIGNAL_NOTIFY_FAILED: Emitida siempre que una notificación de un cliente falla.

action_name

El nombre de la acción.

callback

La función callback para determinada señal. Típicamente, la función callback toma tres parámetros. Siendo el primer parámetro el identificador service, el segundo parámetro puede ser el identificador de action (en caso de una señal GUPNP_SIGNAL_ACTION_INVOKED) o el mensaje error (en caso de una señal GUPNP_SIGNAL_NOTIFY_FAILED), y el tercer parámetro es arg.

arg

Datos de usuario para el callback.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Errores/Excepciones

Lanza un E_WARNING tanto con una función callback inválida como con una señal inválida.

Ver también

gupnp_root_device_new() - Crea un nuevo dispositivo raíz