Función GetSharedServiceRegistryStateKey (winsvc.h)
Devuelve un identificador de una clave del Registro para un servicio y los programas asociados a los que se va a leer o escribir el estado.
Sintaxis
DWORD GetSharedServiceRegistryStateKey(
SC_HANDLE ServiceHandle,
SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
Parámetros
ServiceHandle
StateType
Miembro del SERVICE_SHARED_REGISTRY_STATE_TYPE especificando el tipo de estado compartido 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 completan correctamente; de lo contrario, un código de error win32.
Comentarios
Para ServiceSharedRegistryStatePersistent, la seguridad del directorio se establece para proporcionar acceso de escritura solo a la cuenta del sistema local, al SID del servicio y a los administradores locales. 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 proporcione el estado de servicio exclusivamente para su uso por el propio servicio, consulte GetServiceRegistryStateKey.
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 11 (compilación 22000) |
| Servidor mínimo compatible | Windows Server 2022 (compilación 20348) |
| Encabezado | winsvc.h |
| Library | Onecore.lib |