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

Confira também

Openservice

GetServiceRegistryStateKey

SERVICE_SID_INFO