pdhGetRawCounterArrayW 函数 (pdh.h)
从指定的计数器返回原始值的数组。 如果要检索包含实例名称通配符的计数器的原始计数器值,请使用此函数。
语法
PDH_FUNCTION PdhGetRawCounterArrayW(
[in] PDH_HCOUNTER hCounter,
[in, out] LPDWORD lpdwBufferSize,
[out] LPDWORD lpdwItemCount,
[out] PPDH_RAW_COUNTER_ITEM_W 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 缓冲区不够大,无法包含对象名称。 如果 lpdwBufferSize 在输入时为零,则此返回值应为预期值。 如果输入的指定大小大于零但小于所需大小,则不应依赖返回的大小来重新分配缓冲区。 |
|
参数无效或格式不正确。 例如,在某些版本中,如果输入的指定大小大于零但小于所需大小,则可能会收到此错误。 |
|
计数器句柄无效。 |
注解
应调用此函数两次,第一次获取所需的缓冲区大小 (将 ItemBuffer 设置为 NULL ,将 lpdwBufferSize 设置为 0) ,第二次调用以获取数据。
计数器的数据在调用 PdhGetRawCounterArray 期间被锁定,以防止在处理调用期间发生任何更改。
注意
pdh.h 标头将 PdhGetRawCounterArray 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | pdh.h |
Library | Pdh.lib |
DLL | Pdh.dll |