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