Función QueryServiceStatus (winsvc.h)

Artículo
08/27/2023

Recupera el estado actual del servicio especificado.

Esta función se ha reemplazado por la función QueryServiceStatusEx . QueryServiceStatusEx devuelve la misma información queryServiceStatus , con la adición del identificador de proceso y la información adicional para el servicio.

Sintaxis

BOOL QueryServiceStatus(
  [in]  SC_HANDLE        hService,
  [out] LPSERVICE_STATUS lpServiceStatus
);

Parámetros

[in] hService

Identificador del servicio. La función OpenService o CreateService devuelve este identificador y debe tener el derecho de acceso SERVICE_QUERY_STATUS. Para obtener más información, consulte Derechos de acceso y seguridad de servicio.

[out] lpServiceStatus

Puntero a una estructura de SERVICE_STATUS que recibe la información de estado.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

El administrador de controles de servicio puede establecer los siguientes códigos de error. Otros códigos de error se pueden establecer mediante las funciones del Registro a las que llama el administrador de control de servicios.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El identificador no tiene derecho de acceso SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE	El identificador no es válido.

Comentarios

La función QueryServiceStatus devuelve la información de estado del servicio más reciente notificada al administrador de control de servicios. Si el servicio acaba de cambiar su estado, es posible que aún no haya actualizado el administrador de control de servicios.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winsvc.h (incluye Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll