QueryServiceStatus-Funktion (winsvc.h)
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 |
|---|---|
|
Das Handle verfügt nicht über das zugriffsrecht SERVICE_QUERY_STATUS. |
|
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 |