queryServiceDynamicInformation 函式 (winsvc.h)

發行項
03/13/2024

擷取與目前服務啟動相關的動態資訊。

語法

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

參數

[in] hServiceStatus

RegisterServiceCtrlHandlerEx 所提供的服務狀態句柄

[in] dwInfoLevel

表示資訊層級。

值	意義
SERVICE_DYNAMIC_INFORMATION_LEVEL_START_REASON	指出與目前服務啟動相關的動態資訊要求。

ppDynamicInfo

動態信息緩衝區。如果此參數有效，回呼函式必須在搭配 LocalFree 函式使用之後釋放緩衝區。

傳回值

如果函式成功，則傳回值為TRUE。

如果函式失敗，傳回值為 FALSE。發生這種情況時，應該呼叫 GetLastError 函式來擷取錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	winsvc.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll