PdhGetRawCounterArrayA 函数 （pdh.h）
从指定的计数器返回原始值的数组。 如果要检索包含实例名称通配符的计数器的原始计数器值，请使用此函数。
语法
PDH_FUNCTION PdhGetRawCounterArrayA(
[in] PDH_HCOUNTER hCounter,
[in, out] LPDWORD lpdwBufferSize,
[out] LPDWORD lpdwItemCount,
[out] PPDH_RAW_COUNTER_ITEM_A ItemBuffer
);
参数
[in] hCounter
要检索其当前原始实例值的计数器的句柄。 PdhAddCounter 函数返回此句柄。
[in, out] lpdwBufferSize
ItemBuffer 缓冲区的大小（以字节为单位）。 如果输入为零，则函数将返回PDH_MORE_DATA并将此参数设置为所需的缓冲区大小。 如果缓冲区大于所需大小，则函数会将此参数设置为所使用的缓冲区的实际大小。 如果输入上的指定大小大于零，但小于所需大小，则不应依赖返回的大小来重新分配缓冲区。
[out] lpdwItemCount
ItemBuffer 缓冲区中的原始计数器值数。
[out] ItemBuffer
接收 PDH_RAW_COUNTER_ITEM 结构的数组的调用方分配的缓冲区;结构包含原始实例计数器值。 如果 lpdwBufferSize 为零，则设置为 NULL。
返回值
如果函数成功，它将返回ERROR_SUCCESS。
如果函数失败，则返回值为 系统错误代码 或 PDH 错误代码。 以下是可能的值。
| 返回代码 | 描述 |
|---|---|
|
itemBuffer 缓冲区 |
|
参数无效或格式不正确。 例如，在某些版本中，如果输入上的指定大小大于零但小于所需大小，则可能会收到此错误。 |
|
计数器句柄无效。 |
言论
应调用此函数两次，第一次获取所需的缓冲区大小（ItemBuffer 设置为 NULL，lpdwBufferSize 为 0），第二次获取数据。
计数器的数据在调用 PdhGetRawCounterArray 期间被锁定，以防止在处理调用期间发生任何更改。
注意
pdh.h 标头将 PdhGetRawCounterArray 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | pdh.h |
| 库 | Pdh.lib |
| DLL | Pdh.dll |