Método AddPrinterConnection de la clase Win32_Printer

El método de clase WMIAddPrinterConnection proporciona una conexión a una impresora existente en la red y la agrega a la lista de impresoras disponibles.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

uint32 AddPrinterConnection(
  [in] string Name
);

Parámetros

Nombre [in]

Nombre descriptivo de la impresora.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o cualquier otro valor para indicar un error. Para obtener códigos de error adicionales, consulte Constantes de error de WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

0

Correcto

5

Acceso denegado

1801

Nombre de impresora no válido

1930

Controlador de impresora incompatible

Ejemplos

El ejemplo Add-PrinterDriver de PowerShell instala todos los controladores de impresora desde un servidor de impresión especificado.

En el ejemplo deListSharedPrintersAddPrintConnection.ps1 PowerShell se enumeran las impresoras compartidas en un comptuer remoto y se ofrece la posibilidad de agregar una conexión de impresora desde el equipo remoto al equipo.

El siguiente ejemplo de código VBScript agrega una impresora local.

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_()

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	Win32_Printer.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de hardware del sistema de equipos

Tareas de WMI: Impresoras e impresión

Win32_Printer