PrintServer.InstallPrintQueue Méthode

Définition

Installe une file d'attente à l'impression, et son pilote d'imprimante associé, sur le serveur d'impression.

Surcharges

InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)

Installe une file d'attente à l'impression classée par ordre de priorité, et pilote d'imprimante associé, sur le serveur d'impression.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)

Installe une file d'attente à l'impression partagée et classée par ordre de priorité, et le pilote d'imprimante associé, sur le serveur d'impression.

InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::IndexedProperties::PrintPropertyDictionary ^ initialParameters);
public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.IndexedProperties.PrintPropertyDictionary initialParameters);
member this.InstallPrintQueue : string * string * string[] * string * System.Printing.IndexedProperties.PrintPropertyDictionary -> System.Printing.PrintQueue
Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, initialParameters As PrintPropertyDictionary) As PrintQueue

Paramètres

printQueueName
String

Nom de la nouvelle file d'attente.

driverName
String

Nom et chemin d'accès du pilote d'imprimante.

portNames
String[]

Identificateurs des ports utilisés par la nouvelle file d'attente.

printProcessorName
String

Nom du processeur d'impression.

initialParameters
PrintPropertyDictionary

Les paramètres qui sont initialisés.

Retours

PrintQueue

Nouvelle PrintQueue.

Exemples

L’exemple suivant montre comment utiliser cette méthode (appelée sur l’objet LocalPrintServer qui hérite de la méthode) PrintServerpour installer une deuxième imprimante qui diffère de ses propriétés d’une imprimante existante uniquement à l’emplacement, au port et à l’état partagé.

LocalPrintServer myLocalPrintServer = new LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer);
PrintQueue sourcePrintQueue = myLocalPrintServer.DefaultPrintQueue;
PrintPropertyDictionary myPrintProperties = sourcePrintQueue.PropertiesCollection;

// Share the new printer using Remove/Add methods
PrintBooleanProperty shared = new PrintBooleanProperty("IsShared", true);
myPrintProperties.Remove("IsShared");
myPrintProperties.Add("IsShared", shared);

// Give the new printer its share name using SetProperty method
PrintStringProperty theShareName = new PrintStringProperty("ShareName", "\"Son of " + sourcePrintQueue.Name +"\"");
myPrintProperties.SetProperty("ShareName", theShareName);

// Specify the physical location of the new printer using Remove/Add methods
PrintStringProperty theLocation = new PrintStringProperty("Location", "the supply room");
myPrintProperties.Remove("Location");
myPrintProperties.Add("Location", theLocation);

// Specify the port for the new printer
String[] port = new String[] { "COM1:" };

// Install the new printer on the local print server
PrintQueue clonedPrinter = myLocalPrintServer.InstallPrintQueue("My clone of " + sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties);
myLocalPrintServer.Commit();

// Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName);
Console.WriteLine("Press Return to continue ...");
Console.ReadLine();
Dim myLocalPrintServer As New LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer)
Dim sourcePrintQueue As PrintQueue = myLocalPrintServer.DefaultPrintQueue
Dim myPrintProperties As PrintPropertyDictionary = sourcePrintQueue.PropertiesCollection

' Share the new printer using Remove/Add methods
Dim [shared] As New PrintBooleanProperty("IsShared", True)
myPrintProperties.Remove("IsShared")
myPrintProperties.Add("IsShared", [shared])

' Give the new printer its share name using SetProperty method
Dim theShareName As New PrintStringProperty("ShareName", """Son of " & sourcePrintQueue.Name & """")
myPrintProperties.SetProperty("ShareName", theShareName)

' Specify the physical location of the new printer using Remove/Add methods
Dim theLocation As New PrintStringProperty("Location", "the supply room")
myPrintProperties.Remove("Location")
myPrintProperties.Add("Location", theLocation)

' Specify the port for the new printer
Dim port() As String = { "COM1:" }


' Install the new printer on the local print server
Dim clonedPrinter As PrintQueue = myLocalPrintServer.InstallPrintQueue("My clone of " & sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties)
myLocalPrintServer.Commit()

' Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName)
Console.WriteLine("Press Return to continue ...")
Console.ReadLine()

S’applique à

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes);
public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes);
member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes -> System.Printing.PrintQueue
Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes) As PrintQueue

Paramètres

printQueueName
String

Nom de la nouvelle file d'attente.

driverName
String

Nom et chemin d'accès du pilote d'imprimante.

portNames
String[]

Identificateurs des ports utilisés par la nouvelle file d'attente.

printProcessorName
String

Nom du processeur d'impression.

printQueueAttributes
PrintQueueAttributes

Les attributs, comme indicateurs, de la nouvelle file d'attente.

Retours

PrintQueue

Objet PrintQueue nouvellement créé.

S’applique à

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)

Installe une file d'attente à l'impression classée par ordre de priorité, et pilote d'imprimante associé, sur le serveur d'impression.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes, System::Printing::PrintQueueStringProperty ^ printQueueProperty, int printQueuePriority, int printQueueDefaultPriority);
public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes, System.Printing.PrintQueueStringProperty printQueueProperty, int printQueuePriority, int printQueueDefaultPriority);
member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes * System.Printing.PrintQueueStringProperty * int * int -> System.Printing.PrintQueue
Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes, printQueueProperty As PrintQueueStringProperty, printQueuePriority As Integer, printQueueDefaultPriority As Integer) As PrintQueue

Paramètres

printQueueName
String

Nom de la nouvelle file d'attente.

driverName
String

Nom et chemin d'accès du pilote d'imprimante.

portNames
String[]

Identificateurs des ports utilisés par la nouvelle file d'attente.

printProcessorName
String

Nom du processeur d'impression.

printQueueAttributes
PrintQueueAttributes

Les attributs, comme indicateurs, de la nouvelle file d'attente.

printQueueProperty
PrintQueueStringProperty

Le commentaire, emplacement ou nom de partage de la nouvelle file d'attente.

printQueuePriority
Int32

Une valeur de 1 à 99 qui spécifie la priorité de cette file d'attente à l'impression par rapport aux autres files d'attente qui sont hébergées par le serveur d'impression.

printQueueDefaultPriority
Int32

Une valeur de 1 à 99 qui spécifie la priorité par défaut des travaux d'impression qui sont envoyés à la file d'attente.

Retours

PrintQueue

Objet PrintQueue nouvellement créé.

Remarques

Utilisez le printQueueProperty paramètre pour initialiser un, et un seul, des propriétés ou Location des propriétés de CommentShareNamela file d’attente. Si vous souhaitez initialiser plusieurs, utilisez la InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) surcharge de cette méthode.

S’applique à

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)

Installe une file d'attente à l'impression partagée et classée par ordre de priorité, et le pilote d'imprimante associé, sur le serveur d'impression.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes, System::String ^ printQueueShareName, System::String ^ printQueueComment, System::String ^ printQueueLocation, System::String ^ printQueueSeparatorFile, int printQueuePriority, int printQueueDefaultPriority);
public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes, string printQueueShareName, string printQueueComment, string printQueueLocation, string printQueueSeparatorFile, int printQueuePriority, int printQueueDefaultPriority);
member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes * string * string * string * string * int * int -> System.Printing.PrintQueue
Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes, printQueueShareName As String, printQueueComment As String, printQueueLocation As String, printQueueSeparatorFile As String, printQueuePriority As Integer, printQueueDefaultPriority As Integer) As PrintQueue

Paramètres

printQueueName
String

Nom de la nouvelle file d'attente.

driverName
String

Nom et chemin d'accès du pilote d'imprimante.

portNames
String[]

Identificateurs des ports utilisés par la nouvelle file d'attente.

printProcessorName
String

Nom du processeur d'impression.

printQueueAttributes
PrintQueueAttributes

Les attributs, comme indicateurs, de la nouvelle file d'attente.

printQueueShareName
String

Nom de partage de la nouvelle file d'attente à l'impression.

printQueueComment
String

Commentaire sur la file d’attente visible par les utilisateurs dans l’interface utilisateur de Microsoft Windows.

printQueueLocation
String

Emplacement de la nouvelle file d'attente.

printQueueSeparatorFile
String

Le chemin d'accès d'un fichier qui est inséré au début de chaque travail d'impression.

printQueuePriority
Int32

Une valeur de 1 à 99 qui spécifie la priorité de la file d'attente par rapport aux autres files d'attente hébergées par le serveur d'impression.

printQueueDefaultPriority
Int32

Une valeur de 1 à 99 qui spécifie la priorité par défaut des nouveaux travaux d'impression qui sont envoyés à la file d'attente.

Retours

PrintQueue

Objet PrintQueue nouvellement créé.

Remarques

Si vous ne souhaitez pas initialiser les trois propriétés ou les trois de la file d’attente ShareNameComment; vous pouvez passer une chaîne vide pour un ou plusieurs de printQueueShareName, printQueueCommentet printQueueLocation.Location Si vous souhaitez initialiser une seule de ces propriétés, utilisez la InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) surcharge de cette méthode.

S’applique à