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 |
|
| Archivo DLL |
|