Méthode AddPrinterConnection de la classe Win32_Printer
La méthode de classe WMIAddPrinterConnection fournit une connexion à une imprimante existante sur le réseau et l’ajoute à la liste des imprimantes disponibles.
Cette rubrique utilise la syntaxe MOF (Managed Object Format). 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 [in]
-
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 des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.
-
0
-
Succès
-
5
-
accès refusé
-
1801
-
Nom de l’imprimante non valide
-
1930
-
Pilote d’imprimante incompatible
Exemples
L’exemple PowerShell Add-PrinterDriver installe tous les pilotes d’imprimante à partir d’un serveur d’impression spécifié.
L’exemple PowerShellListSharedPrintersAddPrintConnection.ps1répertorie les imprimantes partagées sur un comptuer distant et vous permet d’ajouter une connexion d’imprimante à partir de l’ordinateur distant à 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_()
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|