Funzione QueryServiceStatus (winsvc.h)

Articolo
08/27/2023

Recupera lo stato corrente del servizio specificato.

Questa funzione è stata sostituita dalla funzione QueryServiceStatusEx . QueryServiceStatusEx restituisce le stesse informazioni restituite da QueryServiceStatus , con l'aggiunta dell'identificatore del processo e informazioni aggiuntive per il servizio.

Sintassi

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

Parametri

[in] hService

Handle per il servizio. Questo handle viene restituito dalla funzione OpenService o CreateService e deve avere il diritto di accesso SERVICE_QUERY_STATUS. Per altre informazioni, vedere Sicurezza del servizio e diritti di accesso.

[out] lpServiceStatus

Puntatore a una struttura di SERVICE_STATUS che riceve le informazioni sullo stato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

I codici di errore seguenti possono essere impostati dal gestore di controllo del servizio. Altri codici di errore possono essere impostati dalle funzioni del Registro di sistema chiamate dal gestore di controllo del servizio.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	L'handle non dispone del diritto di accesso SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE	Handle non valido.

Commenti

La funzione QueryServiceStatus restituisce le informazioni sullo stato del servizio più recenti segnalate al gestore di controllo del servizio. Se il servizio ha appena modificato lo stato, potrebbe non essere stato ancora aggiornato il gestore di controllo del servizio.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsvc.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll