PdhCollectQueryDataWithTime 関数 (pdh.h)

  • [アーティクル]

指定したクエリ内のすべてのカウンターの現在の生データ値を収集し、各カウンターの状態コードを更新します。

構文

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

パラメーター

[in, out] hQuery

データを収集するクエリのハンドル。 PdhOpenQuery 関数は、このハンドルを返します。

[out] pllTimeStamp

クエリの最初のカウンター値が取得されたときのタイム スタンプ。 時刻は FILETIME として指定されます。

戻り値

関数が成功すると、ERROR_SUCCESSが返されます。 それ以外の場合、関数は システム エラー コード または PDH エラー コードを返します。

使用できる値を次に示します。

リターン コード 説明
PDH_INVALID_HANDLE
 クエリ ハンドルが無効です。
PDH_NO_DATA
 現在、クエリにはカウンターがありません。

注釈

クエリ内のカウンターのカウンター データを収集する場合は、この関数を呼び出します。 PDH は、現在のコレクションと前のコレクションの生カウンター値を格納します。

現在の生カウンター値を取得する場合は、 PdhGetRawCounterValue 関数を呼び出します。 カウンター値の表示可能な値を計算する場合は、 PdhGetFormattedCounterValue を呼び出します。 カウンター パスにインスタンス名のワイルドカードが含まれている場合は、代わりに PdhGetRawCounterArray 関数と PdhGetFormattedCounterArray 関数をそれぞれ呼び出します。

PdhCollectQueryDataEx が 1 つのカウンター インスタンスからのデータに対してのみ呼び出され、カウンター インスタンスが存在しない場合、関数はPDH_NO_DATAを返します。 ただし、複数のカウンターのデータに対してクエリを実行すると、カウンター インスタンスの 1 つがまだ存在しない場合でも、 PdhCollectQueryDataEx はERROR_SUCCESSを返す可能性があります。 これは、指定したカウンター インスタンスが存在しないか、存在するがまだ作成されていないのかが不明であるためです。 この場合は、対象のカウンター インスタンスごとに PdhGetRawCounterValue 関数または PdhGetFormattedCounterValue 関数を呼び出して、それらが存在するかどうかを判断します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー pdh.h
Library Pdh.lib
[DLL] Pdh.dll

こちらもご覧ください

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery