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 関数を呼び出して、それらが存在するかどうかを判断します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | pdh.h |
| Library | Pdh.lib |
| [DLL] | Pdh.dll |