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 は、現在のコレクションと前のコレクションの生カウンター値を格納します。

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

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

要件

こちらもご覧ください

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery