win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Consulta el estado de un servicio

Descripción

win32_query_service_status(string $servicename, string $machine = null): array

Consulta el estado actual de un servicio, devolviendo un array de información.

Parámetros

servicename: El nombre corto del servicio.
machine: El nombre opcional de la máquina. Si se omite, se utilizará la máquina local.

Valores devueltos

Devuelve un array que contiene la siguiente información en caso de éxito.

Antes de la versión 1.0.0, false si hay un problema con los parámetros o Código de error Win32 en caso de error.

ServiceType: El dwServiceType. Consulte las máscaras de tipo de servicio Win32Service.
CurrentState: El dwCurrentState. Consulte las constantes de estado de los servicios Win32Service.
ControlsAccepted: Qué controles de servicio son aceptados por el servicio. Consulte las máscaras aceptadas para los mensajes de control de servicio Win32Service.
Win32ExitCode: Si el servicio termina, el código de retorno del proceso. Este valor es igual a WIN32_ERROR_SERVICE_SPECIFIC_ERROR si el modo de salida no es correcto. Consulte códigos de error Win32Service y win32_set_service_exit_mode().
ServiceSpecificExitCode: Si el servicio termina con una condición de error, el código específico del servicio que se registrará en el registro de eventos es visible aquí. Este valor es igual al valor definido por win32_set_service_exit_code().
CheckPoint: Si el servicio se detiene, mantiene el número actual de punto de control. Esto es utilizado por SCM como una especie de latido para detectar un proceso de servicio detenido. El valor del punto de control se interpreta mejor en conjunción con el valor WaitHint.
WaitHint: Si el servicio se detiene, establecerá un WaitHint a un valor de punto de control que indique la ejecución al 100%. Esto puede ser utilizado para implementar una barra de progreso.
ProcessId: El identificador de proceso de ventana. Si es 0, el proceso no está en ejecución.
ServiceFlags: El dwServiceFlags. Consulte las constantes utilizadas para las banderas de los servicios Win32Service.

Errores/Excepciones

Se lanzará una ValueError si el valor del argumento servicename está vacío.

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 1.0.0	El tipo de retorno es ahora array, antes era mixed.

Ver también

Las constantes Win32Service predefinidas

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

demers dot alex at gmail dot com ¶

15 years ago

This function will return an array containing the above information as a return value, but if this fails it will return an integer which is a System Error Code. All the System Error Codes can be found here:

http://msdn.microsoft.com/en-us/library/ms681381%28VS.85%29.aspx

In my case, it returned 5, in which I immediately knew why and fixed the issue right away.

In the case of mnemotronic at netscape dot net, here in the documentation notes, it returned 1060 which is:

ERROR_SERVICE_DOES_NOT_EXIST
1060 (0x424)
The specified service does not exist as an installed service.

Again, it should not return FALSE, instead an System Error Code for Windows.

＋add a note