<Return[PQ]><Top>

PdhGetDataSourceTimeRange

Declare Sub Api_PdhGetDataSourceTimeRange Lib "pdh" (ByVal szDataSource$, ByRef pdwNumEntries&, ByRef pInfo As PPDH_TIME_INFO, ByRef dwBufferSize&)

Declare Sub PdhGetDataSourceTimeRange Lib "pdh" (ByVal szDataSource As String, ByRef pdwNumEntries As Long, ByRef pInfo As PPDH_TIME_INFO, ByRef dwBufferSize As Long)

パフォーマンスデータのソースのデータ収集時間とエントリ数、さらに該当する場合はパフォーマンスデータが入ったバッファのサイズを調べる。

パラメータ
szDataSource
    Windows 2000：ログファイルの名前を表す NULL で終わる文字列、または終端の NULL 文字だけの文字列を指定する。ログファイルの

    名前を指定すると、そのログファイルからパフォーマンスデータを取得する。NULL だけを指定すると、リアルタイムデータソースからパフォー

    マンスを取得する。
    Windows NT 4.0：予約されている。NULL を指定する。
pdwNumEntries
    パフォーマンスデータ収集セッションの数へのポインタを指定する。現時点では、1 に設定する。
pInfo
    データ収集時間の指定を受け取る 構造体へのポインタを指定する。
dwBufferSize
    pInfo パラメータが指すバッファのサイズ（バイト数）を指定する。

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。
    関数が失敗すると、PDHMSG.H ヘッダーファイルで定義されている PDH エラーステータスが返る。次のいずれかの値が返る。

    エラ値                                       

説明                                                              

    PDH_INVALID_ARGUMENT

引数が正しくないか、引数の形式が正しくない。

    PDH_INVALID_HANDLE

カウンタのハンドルが無効である。

    次の値が返ることもあります。これはエラーではない。

    値                                                            

説明                                                                   

    PDH_DATA_SOURCE_IS_REAL_TIME

現在のデータソースはリアルタイムデータソースである。

　

解説
    現在のデータソースがリアルタイムデータソースの場合、この関数は PDH_DATA_SOURCE_IS_REAL_TIME を返すだけで、何も行わな

    い。