Méthode AddPrinterConnection de la _ classe Printer Win32

La méthode de classe WMI AddPrinterConnection fournit une connexion à une imprimante existante sur le réseau et l’ajoute à la liste des imprimantes disponibles.

Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.

Syntaxe

uint32 AddPrinterConnection(
  [in] string Name
);

Paramètres

Nom [ dans]

Nom convivial de l’imprimante.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou toute autre valeur pour indiquer une erreur. Pour obtenir d’autres codes d’erreur, consultez constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir les valeurs de HRESULT générales, consultez codes d’erreur système.

0

Succès

5

accès refusé

1801

Nom d’imprimante non valide

1930

Pilote d’imprimante incompatible

Exemples

L’exemple de code PowerShell Add-PrinterDriver installe tous les pilotes d’imprimante à partir d’un serveur d’impression spécifié.

L’exemple ListSharedPrintersAddPrintConnection.ps1 PowerShell répertorie les imprimantes partagées sur un ordinateur distant et vous donne la possibilité d’ajouter une connexion d’imprimante entre l’ordinateur distant et votre ordinateur.

L’exemple de code VBScript suivant ajoute une imprimante locale.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
Win32 _ Printer. mof
DLL
CIMWin32.dll

Voir aussi

Classes matérielles du système informatique

Tâches WMI : imprimantes et impression

_Imprimante Win32