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	Win32_Printer.mof
DLL	CIMWin32.dll

Siehe auch

Hardwareklassen des Computersystems

WMI-Aufgaben: Drucker und Druck

Win32_Printer