Freigeben über


CM_Connect_MachineA-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 wurde die Funktionalität für den Zugriff auf Remotecomputer 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_MachineA(
  [in, optional] PCSTR     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 Den Betriebssystemen Windows 8 und Windows Server 2012 und höher entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Versionen von Windows ausgeführt werden.

Anforderungen

   
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