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が含まれます。