queryServiceDynamicInformation 函数 (winsvc.h)

项目
03/04/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)
Library	Advapi32.lib
DLL	Advapi32.dll