PdhGetDataSourceTimeRangeA 関数 (pdh.h)

時間範囲、エントリ数、および該当する場合は、指定された入力ソースからのパフォーマンス データを含むバッファーのサイズを決定します。

データ ソースにハンドルを使用するには、PdhGetDataSourceTimeRangeH 関数を使用します。

構文

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

パラメーター

[in] szDataSource

時間範囲情報の取得元のログ ファイルの名前を指定する null で終わる文字列。

[out] pdwNumEntries

pInfo バッファー内の構造体の数。 この関数は 1 つの時間範囲についてのみ情報を収集するため、値は通常 1、エラーが発生した場合は 0 になります。

[out] pInfo

時間範囲を受け取る PDH_TIME_INFO 構造体。

[in] pdwBufferSize

PDH_TIME_INFO 構造体のサイズ (バイト単位)。

戻り値

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

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

リターン コード	形容
PDH_INVALID_ARGUMENT	パラメーターが無効であるか、正しく書式設定されていません。
PDH_INVALID_HANDLE	カウンター ハンドルが無効です。
PDH_DATA_SOURCE_IS_REAL_TIME	現在のデータ ソースはリアルタイム データ ソースです。

備考

手記

pdh.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PdhGetDataSourceTimeRange を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	pdh.h
ライブラリ	Pdh.lib
DLL	Pdh.dll

関連項目

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange の