Función GetServiceRegistryStateKey (winsvc.h)

Devuelve un identificador de una clave del Registro para que un servicio lea o escriba el estado.

Sintaxis

DWORD GetServiceRegistryStateKey(
  SERVICE_STATUS_HANDLE       ServiceStatusHandle,
  SERVICE_REGISTRY_STATE_TYPE StateType,
  DWORD                       AccessMask,
  HKEY                        *ServiceStateKey
);

Parámetros

ServiceStatusHandle

Identificador de la estructura de información de estado del servicio actual. La función RegisterServiceCtrlHandler devuelve este identificador.

StateType

Miembro del SERVICE_REGISTRY_STATE_TYPE especificando el tipo de estado para el que se recupera la clave del Registro del servicio.

AccessMask

Máscara de acceso con la que se intenta abrir la clave de estado. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.

ServiceStateKey

Recibe el identificador de clave del Registro de salida.

Valor devuelto

ERROR_SUCCESS cuando todas las operaciones se completen correctamente; de lo contrario, un código de error win32.

Comentarios

Para ServiceRegistryStatePersistent, la seguridad del directorio se establece para proporcionar solo acceso de escritura a la cuenta del sistema local y al SID del servicio. Asegúrese de que los SID de servicio están habilitados para cualquier servicio que llame a esta API. Para obtener más información, consulte SERVICE_SID_INFO.

Para obtener una API similar que proporciona el estado del servicio que se puede compartir con programas asociados, consulte GetSharedServiceRegistryStateKey.

El administrador de control de servicios elimina todas las claves del Registro de estado del servicio una vez que se desinstala el servicio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 2004 (10.0; Compilación 19041)
Servidor mínimo compatible	Windows Server, versión 2004 (10.0; Compilación 19041)
Encabezado	winsvc.h
Library	Onecore.lib

Consulte también

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO