Função GetServiceRegistryStateKey (winsvc.h)

  • Artigo

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

Confira também

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO