QueryServiceDynamicInformation-Funktion (winsvc.h)

Artikel
03/13/2024

Ruft dynamische Informationen im Zusammenhang mit dem aktuellen Dienststart ab.

Syntax

BOOL QueryServiceDynamicInformation(
  [in] SERVICE_STATUS_HANDLE hServiceStatus,
  [in] DWORD                 dwInfoLevel,
       PVOID                 *ppDynamicInfo
);

Parameter

[in] hServiceStatus

Ein von RegisterServiceCtrlHandlerEx bereitgestelltes Dienst-status-Handle

[in] dwInfoLevel

Gibt die Informationsebene an.

Wert	Bedeutung
SERVICE_DYNAMIC_INFORMATION_LEVEL_START_REASON	Gibt eine Anforderung für dynamische Informationen im Zusammenhang mit dem aktuellen Dienststart an.

ppDynamicInfo

Ein dynamischer Informationspuffer. Wenn dieser Parameter gültig ist, muss die Rückruffunktion den Puffer nach der Verwendung mit der Funktion LocalFree freigeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. In diesem Fall sollte die GetLastError-Funktion aufgerufen werden, um den Fehlercode abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsvc.h (windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll