Voltar à lista
Windows Win32Serviçosadvapi32.dllDepreciada

QueryServiceStatus

Consulta o estado atual de um serviço (parado, iniciando, em execução, parando, etc.).

Descrição

Análogo a `systemctl status` no Linux, embora retornando apenas o estado estruturado, não logs.

Header: winsvc.hDLL: advapi32.dll

Depreciada

Prefira QueryServiceStatusEx, que retorna também o PID do processo do serviço e mais detalhes.

Assinatura

BOOL QueryServiceStatus(SC_HANDLE hService, LPSERVICE_STATUS lpServiceStatus);

Parâmetros

ParâmetroTipoDescrição
hServiceSC_HANDLEHandle do serviço, aberto com SERVICE_QUERY_STATUS.
lpServiceStatusLPSERVICE_STATUSRecebe o estado atual do serviço.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INVALID_HANDLE(6)
O identificador (handle) informado é inválido.

Relacionadas