CM_Connect_MachineW-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 Funktionalität für den Zugriff auf Remotecomputer wurde entfernt. Sie können nicht auf Remotecomputer zugreifen, wenn Sie unter diesen Versionen von Windows ausgeführt werden.]

Die funktion CM_Connect_Machine stellt eine Verbindung mit einem Remotecomputer her.

Syntax

CMAPI CONFIGRET CM_Connect_MachineW(
  [in, optional] PCWSTR    UNCServerName,
  [out]          PHMACHINE phMachine
);

Parameter

[in, optional] UNCServerName

Vom Aufrufer bereitgestellter Zeiger auf eine Textzeichenfolge, die den UNC-Namen einschließlich des \ Präfixes des Systems darstellt, für das eine Verbindung hergestellt wird. Wenn der Zeiger NULL ist, wird das lokale System verwendet.

[out] phMachine

Adresse eines Standorts, an den ein Computerhandle empfangen werden soll.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Aufrufer von CM_Connect_Machine müssen CM_Disconnect_Machine aufrufen, um die Zuordnung des Computerhandles wieder aufzurufen, nachdem es nicht mehr benötigt wird.

Verwenden Sie mit dieser Funktion abgerufene Computerhandles nur mit den PnP-Konfigurations-Manager-Funktionen.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und späteren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn Sie unter diesen Versionen von Windows ausgeführt werden.

Anforderungen

Weitere Informationen

CM_Disconnect_Machine