<Return[PQ]><Top>

PdhLookupPerfIndexByName

Declare Sub Api_PdhLookupPerfIndexByName Lib "pdh" Alias "PdhLookupPerfIndexByName" (ByVal szMachineName$, ByVal szNameBuffer$, ByRef pdwIndex&)

Declare Sub PdhLookupPerfIndexByName Lib "pdh" (ByVal szMachineName As String, ByVal szNameBuffer As String, ByRef pdwIndex As Long)

特定のカウンタ名に対応するカウンタインデックスを取得する。

パラメータ
szMachineName
    カウンタが存在するコンピュータの名前が入ったバッファへのポインタを指定する。コンピュータ名は、DNS 名、IP アドレスのどちらでも指定

    できる。
szNameBuffer
    カウンタのフルネームへのポインタを指定する。このカウンタのインデックスを取得する。
pdwIndex
    カウンタのインデックスを受け取るバッファへのポインタを指定する。このバッファは呼び出し側が確保する。

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

    エラー値                                        

説明                                                              

    PDH_INVALID_ARGUMENT

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