Método AddPrinterConnection da classe Win32_Printer

O método de classe WMIAddPrinterConnection fornece uma conexão com uma impressora existente na rede e a adiciona à lista de impressoras disponíveis.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 AddPrinterConnection(
  [in] string Name
);

Parâmetros

Nome [in]

Nome amigável para a impressora.

Valor retornado

Retorna um dos valores listados na lista a seguir ou qualquer outro valor para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

0

Sucesso

5

Acesso negado

1801

Nome da Impressora Inválido

1930

Driver de impressora incompatível

Exemplos

O exemplo do PowerShell Add-PrinterDriver instala todos os drivers de impressora de um servidor de impressão especificado.

O ListSharedPrintersAddPrintConnection.ps1 exemplo do PowerShell lista impressoras compartilhadas em um comptuer remoto e oferece a capacidade de adicionar uma conexão de impressora do computador remoto ao seu computador.

O exemplo de código VBScript a seguir adiciona uma impressora 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Confira também

Classes de hardware do sistema de computador

Tarefas WMI: impressoras e impressão

Win32_Printer