PdhConnectMachineA 関数 (pdh.h)

  • [アーティクル]

指定したコンピューターに接続します。

構文

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

パラメーター

[in] szMachineName

接続するコンピューターの名前を指定する Null で終わる文字列。 NULL の場合、PDH はローカル コンピューターに接続します。

戻り値

関数が成功すると、ERROR_SUCCESSが返されます。

関数が失敗した場合、戻り値は システム エラー コード または PDH エラー コードです。 使用できる値を次に示します。

リターン コード 説明
PDH_CSTATUS_NO_MACHINE
 指定したコンピューターに接続できません。 コンピューターがオンではない、PDH をサポートしていない、ネットワークに接続されていない、またはユーザーによるリモート接続またはリモート パフォーマンス監視を防ぐアクセス許可がレジストリに設定されていることが原因で発生する可能性があります。
PDH_MEMORY_ALLOCATION_FAILURE
 動的メモリ ブロックを割り当てることができません。 システムで実行されているアプリケーションの数が多すぎるか、メモリ ページング ファイルが不足しているために、システムに重大なメモリ不足が発生した場合に発生します。

注釈

通常、アプリケーションはこの関数を呼び出さず、代わりにアプリケーションがクエリにカウンターを追加するときに接続が行われます。

ただし、[カウンターの参照] ダイアログ ボックスの [コンピューターからカウンターを選択する] ボックスの一覧に、ローカル コンピューター以外のコンピューターを含める場合は、この関数を使用できます。 詳細については、PDH_BROWSE_DLG_CONFIG構造に 関するページを 参照してください。

注意

pdh.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PdhConnectMachine を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー pdh.h
Library Pdh.lib
[DLL] Pdh.dll

こちらもご覧ください

PdhEnumMachines