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 エラーステータスが返る。次のいずれかの値が返る。