PdhSetQueryTimeRange 関数 (pdh.h)

ログファイルから読み取ることができるサンプルを、指定された時間範囲内のサンプルに制限します(含む)。

構文

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

[in] hQuery

クエリを処理します。 PdhOpenQuery 関数は、このハンドルを返します。

[in] pInfo

時間範囲を指定する PDH_TIME_INFO 構造体。時刻をローカルファイル時刻として指定します。終了時刻は開始時刻より大きくする必要があります。すべてのレコードを読み取る場合は、開始時刻に 0、終了時刻の最大 64 ビット値を指定できます。

関数が成功すると、ERROR_SUCCESSが返されます。

関数が失敗した場合、戻り値はシステムエラーコードまたは PDH エラーコードです。使用できる値を次に示します。

リターンコード	説明
PDH_INVALID_HANDLE	クエリハンドルが無効です。
PDH_INVALID_ARGUMENT	終了時刻範囲の値は、開始時刻の範囲の値より大きくする必要があります。

指定した時間範囲の末尾またはログファイルの末尾に達すると、 PdhCollectQueryData 関数はPDH_NO_MORE_DATAを返します。