<Return[PQ]><Top>

PdhGetDefaultPerfCounter

Declare Sub Api_PdhGetDefaultPerfCounter Lib "pdh" Alias "PdhGetDefaultPerfCounter" (ByVal szDataSource$, ByVal szMachineName$, ByVal szObjectName$, ByVal szDefaultCounterName$, ByRef pcchBufferSize&)

Declare Sub PdhGetDefaultPerfCounter Lib "pdh" (ByVal szDataSource As String, ByVal szMachineName As String, ByVal szObjectName As String, ByVal szDefaultCounterName As String, ByRef pcchBufferSize As Long)

指定したオブジェクトの既定カウンタの名前を取得する。カウンタブラウザリストおよびカPerfウンタブラウザコンボボックスの初期の選択値を設定できる。

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

    は、パフォーマンスデータがログファイルから取得される。NULL だけを指定した場合は、リアルタイムのデータソースからパフォーマンスデー

    タが取得される。
    Windows NT 4.0:予約されている。NULL を指定する。
szMachineName
     問い合わせ対象のコンピュータの名前を指定する。
szObjectName
    szMachineName で指定したコンピュータ上の、問い合わせ対象のオブジェクトの名前を指定する。

szDefaultCounterName
    指定したオブジェクトの既定カウンタの名前を受け取るバッファへのポインタを指定する。pcchBufferSize が指す DWORD 変数の値が 0 の

    場合は、NULL を指定できる。
pcchBufferSize
    DWORD 変数へのポインタを指定する。この変数は、szDefaultCounterName が指すバッファのサイズに設定しておく。関数から制御が戻

    るとき、取得したカウンタ名のサイズに設定される。0 に設定して関数を呼び出すと、オブジェクト名を受け取るために必要なバッファのサイズ

    (文字数)に設定され、バッファにデータはコピーされない。

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

    エラ値                                                            

説明                                                              

    PDH_INSUFFICIENT_BUFFER

用意したバッファが小さすぎて、取得可能なデータが入らない。

    PDH_INVALID_ARGUMENT

必要な引数が無効か、予約済み引数に NULL 以外を指定した。

    PDH_MEMORY_ALLOCATION_FAILURE

必要な一時バッファを確保できなかった。

    PDH_CSTATUS_NO_MACHINE

指定したコンピュータがオフラインになっているか、利用できない。

    PDH_CSTATUS_NO_COUNTERNAME

既定のオブジェクト名を読み取ることができないか、既定のオブジェクトが見つからない。

    PDH_CSTATUS_NO_OBJECT

指定したコンピュータ上で指定したオブジェクトが見つからなかった。

    PDH_CSTATUS_NO_COUNTER

指定したオブジェクトの既定のカウンタが見つからなかった。