array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', 2 => 'Devuelve el último mensaje de control que ha sido enviado a este servicio', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funciones win32service', ), 'prev' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', ), 'next' => array ( 0 => 'function.win32-get-service-env-vars.php', 1 => 'win32_get_service_env_vars', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/win32service/functions/win32-get-last-control-message.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_get_last_control_message

(PECL win32service >=0.1.0)

win32_get_last_control_message — Devuelve el último mensaje de control que ha sido enviado a este servicio

Descripción

win32_get_last_control_message(): int

Devuelve el código de control que ha sido enviado por última vez a este proceso de servicio. Cuando funciona como servicio, debe verificar periódicamente para determinar si el servicio debe ser detenido.

Precaución

Desde la versión 0.2.0, esta función solo funciona en línea de comandos ("cli" SAPI). Está deshabilitada en otros casos.

Parámetros

Esta función no contiene ningún parámetro.

Valores devueltos

Devuelve una constante de control que será una de las constantes de control de mensajes de servicio Win32Service : WIN32_SERVICE_CONTROL_CONTINUE, WIN32_SERVICE_CONTROL_DEVICEEVENT, WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE, WIN32_SERVICE_CONTROL_INTERROGATE, WIN32_SERVICE_CONTROL_NETBINDADD, WIN32_SERVICE_CONTROL_NETBINDDISABLE, WIN32_SERVICE_CONTROL_NETBINDENABLE, WIN32_SERVICE_CONTROL_NETBINDREMOVE, WIN32_SERVICE_CONTROL_PARAMCHANGE, WIN32_SERVICE_CONTROL_PAUSE, WIN32_SERVICE_CONTROL_POWEREVENT, WIN32_SERVICE_CONTROL_PRESHUTDOWN, WIN32_SERVICE_CONTROL_SESSIONCHANGE, WIN32_SERVICE_CONTROL_SHUTDOWN, WIN32_SERVICE_CONTROL_STOP.

Si el valor está entre 128 y 255, el código de control es personalizado.

Errores/Excepciones

Antes de la versión 1.0.0, si esta función se utiliza fuera del SAPI "cli", se emitirá un error E_ERROR.

A partir de la versión 1.0.0, lanzará una Win32ServiceException si el SAPI no es "cli"

Historial de cambios

Versión Descripción
PECL win32service 1.0.0 Lanzará una ValueError si un argumento es inválido, antes false era retornado.
PECL win32service 1.0.0 Lanzará una Win32ServiceException en caso de error, antes un Código de error Win32 era retornado.
PECL win32service 0.2.0 Esta función solo funciona en el SAPI "cli".

Ver también