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 |