CM_Connect_MachineA関数 (cfgmgr32.h)

[Windows 8 および Windows Server 2012 以降では、リモートマシンにアクセスするための機能が削除されました。これらのバージョンの Windows で実行している場合、リモートコンピューターにアクセスすることはできません。]

CM_Connect_Machine関数は、リモートコンピューターへの接続を作成します。

構文

CMAPI CONFIGRET CM_Connect_MachineA(
  [in, optional] PCSTR     UNCServerName,
  [out]          PHMACHINE phMachine
);

[in, optional] UNCServerName

接続が確立されるシステムの UNC 名 (プレフィックスを含む \ ) を表すテキスト文字列への呼び出し元指定のポインター。ポインターが NULL の場合は、ローカルシステムが使用されます。

[out] phMachine

マシンハンドルを受信する場所のアドレス。

メモこの機能は削除されたため、この関数を使用してリモートマシンにアクセスすることは、Windows 8 および Windows Server 2012 以降ではサポートされていません。

操作が成功した場合、関数はCR_SUCCESSを返します。それ以外の場合は、 Cfgmgr32.h で定義されているCR_プレフィックス付きのエラーコードのいずれかを返します。

CM_Connect_Machineの呼び出し元は、CM_Disconnect_Machineを呼び出してマシンハンドルの割り当てを解除する必要があります。

この関数で取得したマシンハンドルは、 PnP 構成マネージャー関数でのみ使用します。

リモートマシンにアクセスする機能は、Windows 8 および Windows Server 2012 以降のオペレーティングシステムで削除されているため、これらのバージョンの Windows で実行している場合はリモートコンピューターにアクセスできません。


サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	cfgmgr32.h (Cfgmgr32.h を含む)
Library	Cfgmgr32.lib