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