PerfEnumerateCounterSet 函数 (perflib.h)

  • 项目

获取在 上注册的计数器集的计数器集标识符

指定的系统。

计数器集标识符是 (GUID) 的全局唯一标识符。

语法

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

参数

[in, optional] szMachine

要为其获取计数器集标识符的计算机的名称。 如果为 NULL，则函数检索本地计算机的计数器集标识符。

[out, optional] pCounterSetIds

指向缓冲区的指针，该缓冲区具有足够的空间来接收 cCounterSetIds 参数指定的 GUID 数。 如果

cCounterSetIds 为 0。

cCounterSetIds

pCounterSetIds 参数指定的缓冲区大小，以 GUID 为单位。

[out] pcCounterSetIdsActual

获取计数器集标识符实际所需的缓冲区大小。 含义取决于函数的值

返回。

函数返回值 pcCounterSetIdsActual 的含义
ERROR_SUCCESS The number of

函数存储在 pCounterSetIds 指定的缓冲区中的 GUID。
ERROR_NOT_ENOUGH_MEMORY The

大小 (所需缓冲区的 GUID) 。 将缓冲区放大到所需的

调整大小，然后再次调用函数。
其他 该值未定义，不应使用。

返回值

返回代码 说明
ERROR_SUCCESS
 函数成功将所有内容集标识符存储在 pCounterSetIds 指定的缓冲区中。 pcCounterSetIdsActual 指向的值指示缓冲区中实际存储的计数器集标识符数。
ERROR_NOT_ENOUGH_MEMORY
 pCounterSetIds 指定的缓冲区不够大，无法存储指定系统上计数器集的所有计数器集标识符。 pcCounterSetIdsActual 指向的值指示存储所有计数器集标识符所需的缓冲区大小。 将缓冲区放大到所需的

调整大小，然后再次调用函数。
 

对于其他类型的故障，返回值为 系统错误代码。

要求

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

另请参阅

PerfEnumerateCounterSetInstances