Compartilhar via


Função QueryServiceStatus (winsvc.h)

Recupera o status atual do serviço especificado.

Essa função foi substituída pela função QueryServiceStatusEx . QueryServiceStatusEx retorna as mesmas informações que QueryServiceStatus retorna, com a adição do identificador de processo e informações adicionais para o serviço.

Sintaxe

BOOL QueryServiceStatus(
  [in]  SC_HANDLE        hService,
  [out] LPSERVICE_STATUS lpServiceStatus
);

Parâmetros

[in] hService

Um identificador para o serviço. Esse identificador é retornado pelo OpenService ou pela função CreateService e deve ter o acesso SERVICE_QUERY_STATUS correto. Para obter mais informações, consulte Segurança do serviço e Direitos de Acesso.

[out] lpServiceStatus

Um ponteiro para uma estrutura SERVICE_STATUS que recebe as informações de status.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Os códigos de erro a seguir podem ser definidos pelo gerenciador de controle de serviço. Outros códigos de erro podem ser definidos pelas funções do Registro que são chamadas pelo gerenciador de controle de serviço.

Código de retorno Descrição
ERROR_ACCESS_DENIED
O identificador não tem o acesso de SERVICE_QUERY_STATUS correto.
ERROR_INVALID_HANDLE
O manipulador é inválido.

Comentários

A função QueryServiceStatus retorna o serviço mais recente status informações relatadas ao gerenciador de controle de serviço. Se o serviço acabou de alterar seu status, talvez ele ainda não tenha atualizado o gerenciador de controle de serviço.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winsvc.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

ControlService

CreateService

Openservice

QueryServiceStatusEx

SERVICE_STATUS

Funções de serviço

Inicialização de serviço

SetServiceStatus