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

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

戻り値

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

注釈

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

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

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

要件

こちらもご覧ください

CM_Disconnect_Machine