CM_Connect_MachineW関数 (cfgmgr32.h)

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

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

構文

CMAPI CONFIGRET CM_Connect_MachineW(
  [in, optional] PCWSTR    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