<Return[PQ]><Top>

PdhLookupPerfNameByIndex

Declare Sub Api_PdhLookupPerfNameByIndex Lib "pdh" Alias "PdhLookupPerfNameByIndex" (ByVal szMachineName$, ByVal dwNameIndex&, ByVal szNameBuffer$, ByRef pcchNameBufferSize&)

Declare Sub PdhLookupPerfNameByIndex Lib "pdh" (ByVal szMachineName As String, ByVal dwNameIndex As Long, ByVal szNameBuffer As String, ByRef pcchNameBufferSize As Long)

特定のカウンタインデックスに対応するパフォーマンスオブジェクトの名前を取得する。

パラメータ
szMachineName
    パフォーマンスオブジェクトが存在するコンピュータの名前が入ったバッファへのポインタを指定する。コンピュータの名前は、DNS 名、IP アド

    レスのどちらでも指定できる。
dwNameIndex
    パフォーマンスオブジェクトのインデックスへのポインタを指定する。
szNameBuffer
    パフォーマンスオブジェクトの名前を受け取るバッファへのポインタを指定する。
pcchNameBufferSize
    szNameBuffer パラメータが指すバッファのサイズ(バイト数)を指定する。

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

    エラー値                                        

説明                                                                      

    PDH_INSUFFICIENT_BUFFER

バッファのサイズが不十分で、データを格納できない。

    PDH_INVALID_ARGUMENT

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