PerfOpenQueryHandle 函数 (perflib.h)

创建引用指定系统上的查询的句柄。 查询是计数器规范的列表。

语法

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

参数

[in, optional] szMachine

要获取其查询句柄的计算机的名称。

[out] phQuery

查询的句柄。 调用 PerfCloseQueryHandle 以在不再需要句柄时关闭它。

返回值

如果函数成功，则返回ERROR_SUCCESS。

如果函数失败，则返回值为 系统错误代码。

注解

使用 PerfAddCounters 和 PerfDeleteCounters 在列表中添加或删除计数器规范。 使用 PerfQueryCounterInfo 获取当前列表中的计数器规范，并确定 PerfQueryCounterData 将返回每个计数器的数据的索引。 使用 PerfQueryCounterData 检索与计数器规范匹配的计数器的值。

要求

要求	值
最低受支持的客户端	Windows 10版本 1607 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
目标平台	Windows
标头	perflib.h
Library	AdvAPI32.lib
DLL	AdvAPI32.dll

另请参阅

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo