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 |