Função GetSharedServiceRegistryStateKey (winsvc.h)
Retorna um identificador para uma chave do Registro para um serviço e programas associados para ler e/ou gravar o estado.
Sintaxe
DWORD GetSharedServiceRegistryStateKey(
SC_HANDLE ServiceHandle,
SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
Parâmetros
ServiceHandle
StateType
Um membro do SERVICE_SHARED_REGISTRY_STATE_TYPE especificando o tipo de estado compartilhado para o qual a chave do Registro de serviço é recuperada.
AccessMask
A máscara de acesso com a qual tentar abrir a chave de estado. Para obter mais informações, consulte Segurança de chave do Registro e Direitos de Acesso.
ServiceStateKey
Recebe o identificador de chave do Registro de saída.
Retornar valor
ERROR_SUCCESS quando todas as operações forem concluídas com êxito; caso contrário, um código de erro Win32.
Comentários
Para ServiceSharedRegistryStatePersistent, a segurança do diretório é definida para fornecer acesso de gravação apenas à conta do sistema local, ao SID do serviço e aos administradores locais. Verifique se os SIDs de serviço estão habilitados para qualquer serviço que chame essa API. Para obter mais informações, consulte SERVICE_SID_INFO.
Para uma API semelhante que fornece o estado do serviço exclusivamente para uso pelo próprio serviço, consulte GetServiceRegistryStateKey.
Todas as chaves do Registro de estado de serviço são excluídas pelo gerenciador de controle de serviço depois que o serviço é desinstalado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 11 (Build 22000) |
| Servidor mínimo com suporte | Windows Server 2022 (Build 20348) |
| Cabeçalho | winsvc.h |
| Biblioteca | Onecore.lib |