QueryServiceStatus-Funktion (winsvc.h)

Artikel
08/27/2023

Ruft den aktuellen status des angegebenen Diensts ab.

Diese Funktion wurde durch die QueryServiceStatusEx-Funktion ersetzt. QueryServiceStatusEx gibt dieselben Informationen zurück, die QueryServiceStatus zurückgibt, wobei der Prozessbezeichner und zusätzliche Informationen für den Dienst hinzugefügt werden.

Syntax

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

Parameter

[in] hService

Ein Handle für den Dienst. Dieses Handle wird von openService oder der CreateService-Funktion zurückgegeben und muss über das SERVICE_QUERY_STATUS-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Dienstsicherheit und Zugriffsrechte.

[out] lpServiceStatus

Ein Zeiger auf eine SERVICE_STATUS-Struktur, die die status Informationen empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Die folgenden Fehlercodes können vom Dienststeuerungs-Manager festgelegt werden. Andere Fehlercodes können von den Registrierungsfunktionen festgelegt werden, die vom Dienststeuerungs-Manager aufgerufen werden.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Das Handle verfügt nicht über das zugriffsrecht SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Die QueryServiceStatus-Funktion gibt die neuesten Dienst-status Informationen zurück, die an den Dienststeuerungs-Manager gemeldet wurden. Wenn der Dienst gerade seine status geändert hat, hat er den Dienststeuerungs-Manager möglicherweise noch nicht aktualisiert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsvc.h (einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll