CM_Connect_MachineW-Funktion (cfgmgr32.h)

  • Artikel

[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.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
 

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

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib

Weitere Informationen

CM_Disconnect_Machine