<Return[PQ]><Top>

PdhConnectMachine

Declare Sub Api_PdhConnectMachine Lib "pdh" Alias "PdhConnectMachine" (ByVal szMachineName$)

Declare Sub PdhConnectMachine Lib "pdh" (ByVal szMachineName As String)

未処理値の配列からカウンタの統計をとる。

パラメータ
szMachineName
    ブラウズ対象のコンピュータの名前を指定する。

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

    エラー値                                                        

説明                                                                                                                      

    PDH_CSTATUS_NO_MACHINE

　

　

指定したコンピュータに接続できない。接続先コンピュータがオンになっていない、Windows NT/Windows 2000 が稼動していない、ネットワークに接続されていない、ユーザーによるリモート接続やリモートパフォーマンスモニタリングを許可しないアクセス権がレジストリに設定されているなどの原因が考えられる。

    PDH_MEMORY_ALLOCATION_FAILURE

　

メモリブロックを動的に割り当てることができない。システムで多くのアプリケーションが実行されていたり、メモリページングファイルが不十分なためシステムのメモリが極端に不足していたりすると、このエラーが発生する。

解説
    アプリケーションは、問い合わせのオープン時やカウンタの追加時よりも都合のよいときに、PdhConnectMachine 関数を使ってリモートコンピ

    ュータに接続することができる。