PdhConnectMachineA 関数 (pdh.h)

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

構文

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

パラメーター

[in] szMachineName

接続するコンピューターの名前を指定する null-terminated 文字列です。 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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	pdh.h
ライブラリ	Pdh.lib
DLL	Pdh.dll

関連項目

PdhEnumMachines の