AddPrinterConnection-Methode der Win32_Printer-Klasse
Die AddPrinterConnectionWMI-Klassenmethode stellt eine Verbindung mit einem vorhandenen Drucker im Netzwerk her und fügt sie der Liste der verfügbaren Drucker hinzu.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 AddPrinterConnection(
[in] string Name
);
Parameter
-
Name [in]
-
Anzeigename für den Drucker.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
0
-
Erfolg
-
5
-
Zugriff verweigert
-
1801
-
Ungültiger Druckername
-
1930
-
Nicht kompatibler Druckertreiber
Beispiele
Im PowerShell-Beispiel "Add-PrinterDriver " werden alle Druckertreiber von einem angegebenen Druckserver installiert.
Das ListSharedPrintersAddPrintConnection.ps1 PowerShell-Beispiel listet freigegebene Drucker auf einem Remotecomptuer auf und bietet Ihnen die Möglichkeit, eine Druckerverbindung vom Remotecomputer zu Ihrem Computer hinzuzufügen.
Im folgenden VBScript-Codebeispiel wird ein lokaler Drucker hinzugefügt.
Dim strPrinterName as String = "Isidoros Printer"
Dim strComputer AsString = My.Computer.Name
Dim objWMIService, objPrinter AsObject
objWMIService = GetObject(
"winmgmts:" _
&
"{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
objPrinter = objWMIService.Get(
"Win32_Printer").SpawnInstance_
objPrinter.Name = strPrinterName
objPrinter.DriverName = "Generic / Text Only"
objPrinter.PortName =
"c:\temp\file.prn"
objPrinter.DeviceID = strPrinterName
'objPrinter.Location = "Athens, Greece"
objPrinter.Network =
False
objPrinter.Shared =
False'objPrinter.ShareName = "MyShareName"
objPrinter.Put_()
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|