PdhGetRawCounterValue 函数 (pdh.h)

返回计数器的当前原始值。

语法

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

[in] hCounter

要从中检索当前原始值的计数器的句柄。 PdhAddCounter 函数返回此句柄。

[out] lpdwType

接收计数器类型。有关计数器类型的列表，请参阅 Windows Server 2003 部署工具包的计数器类型部分。此参数是可选的。

[out] pValue

接收计数器值的 PDH_RAW_COUNTER 结构。

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

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。下面是可能的值。

返回代码	说明
PDH_INVALID_ARGUMENT	参数无效或格式不正确。
PDH_INVALID_HANDLE	计数器句柄无效。

计数器的数据在调用 PdhGetRawCounterValue 期间锁定 (受保护的) ，以防止在调用处理过程中发生任何更改。

如果指定的计数器实例不存在，此函数将返回ERROR_SUCCESS，并且PDH_RAW_COUNTER结构的 CStatus 成员将包含PDH_CSTATUS_NO_INSTANCE。