Função GetServiceRegistryStateKey (winsvc.h)
Retorna um identificador para uma chave do Registro para um serviço ler e/ou gravar o estado.
Sintaxe
DWORD GetServiceRegistryStateKey(
SERVICE_STATUS_HANDLE ServiceStatusHandle,
SERVICE_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
Parâmetros
ServiceStatusHandle
Um identificador para a estrutura de informações status para o serviço atual. Esse identificador é retornado pela função RegisterServiceCtrlHandler .
StateType
Um membro do SERVICE_REGISTRY_STATE_TYPE especificando o tipo de estado para o qual a chave do registro de serviço é retreida.
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 ServiceRegistryStatePersistent, a segurança do diretório é definida para fornecer apenas acesso de gravação à conta do sistema local e ao SID do serviço. 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 obter uma API semelhante que fornece o estado de serviço que pode ser compartilhado com programas associados, consulte GetSharedServiceRegistryStateKey.
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 10, versão 2004 (10.0; Build 19041) |
| Servidor mínimo com suporte | Windows Server, versão 2004 (10.0; Build 19041) |
| Cabeçalho | winsvc.h |
| Biblioteca | Onecore.lib |