PrintServer.InstallPrintQueue Methode

Definition

Namespace:: System.Printing

Assembly:: System.Printing.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

Überlädt

Name	Beschreibung
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)	Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)	Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)	Installiert eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)	Installiert eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

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

Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

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

Parameter

printQueueName: String

Der Name der neuen Warteschlange.

driverName: String

Der Pfad und der Name des Druckertreibers.

portNames: String[]

Die IDs der Ports, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

initialParameters: PrintPropertyDictionary

Die Parameter, die initialisiert werden.

Gibt zurück

PrintQueue

Die neue PrintQueue.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode (aufgerufen für das LocalPrintServer Objekt, das PrintServerdie Methode erbt) verwenden, um einen zweiten Drucker zu installieren, der sich in seinen Eigenschaften von einem vorhandenen Drucker nur an Position, Port und freigegebenem Status unterscheidet.

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

Gilt für:

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

Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

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

Parameter

printQueueName: String

Der Name der neuen Warteschlange.

driverName: String

Der Pfad und der Name des Druckertreibers.

portNames: String[]

Die IDs der Ports, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute als Kennzeichnungen der neuen Warteschlange.

Gibt zurück

PrintQueue

Die neu erstellte PrintQueue.

Gilt für:

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

Installiert eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

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

Parameter

printQueueName: String

Der Name der neuen Warteschlange.

driverName: String

Der Pfad und der Name des Druckertreibers.

portNames: String[]

Die IDs der Ports, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute als Kennzeichnungen der neuen Warteschlange.

printQueueProperty: PrintQueueStringProperty

Der Kommentar, der Speicherort oder der Freigabename der neuen Warteschlange.

printQueuePriority: Int32

Ein Wert von 1 bis 99, der die Priorität dieser Druckwarteschlange relativ zu anderen Warteschlangen angibt, die vom Druckserver gehostet werden.

printQueueDefaultPriority: Int32

Ein Wert von 1 bis 99, der die Standardpriorität von Druckaufträgen angibt, die an die Warteschlange gesendet werden.

Gibt zurück

PrintQueue

Die neu erstellte PrintQueue.

Hinweise

Verwenden Sie den printQueueProperty Parameter, um eins und nur eine der Eigenschaften der Warteschlange ShareName Commentzu Location initialisieren. Wenn Sie mehrere initialisieren möchten, verwenden Sie die InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) Überladung dieser Methode.

Gilt für:

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

Installiert eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver.

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

Parameter

printQueueName: String

Der Name der neuen Warteschlange.

driverName: String

Der Pfad und der Name des Druckertreibers.

portNames: String[]

Die IDs der Ports, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute als Kennzeichnungen der neuen Warteschlange.

printQueueShareName: String

Der Freigabename der neuen Warteschlange.

printQueueComment: String

Ein Kommentar zur Warteschlange, die für Benutzer in der benutzeroberfläche Microsoft Windows sichtbar ist.

printQueueLocation: String

Der Speicherort der neuen Warteschlange.

printQueueSeparatorFile: String

Der Pfad einer Datei, die am Anfang jedes Druckauftrags eingefügt wird.

printQueuePriority: Int32

Ein Wert von 1 bis 99, der die Priorität der Warteschlange relativ zu anderen Warteschlangen angibt, die vom Druckserver gehostet werden.

printQueueDefaultPriority: Int32

Ein Wert von 1 bis 99, der die Standardpriorität neuer Druckaufträge angibt, die an die Warteschlange gesendet werden.

Gibt zurück

PrintQueue

Die neu erstellte PrintQueue.

Hinweise

Wenn Sie nicht alle drei Eigenschaften der Warteschlange ShareName Comment Location initialisieren möchten, können Sie eine leere Zeichenfolge für eine oder mehrere von printQueueShareName, printQueueCommentund .printQueueLocation Wenn Sie nur eine dieser Eigenschaften initialisieren möchten, verwenden Sie die InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) Überladung dieser Methode.

Gilt für:

Feedback

War diese Seite hilfreich?