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