PrintServer.InstallPrintQueue Methode

Referenz

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 auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.

Überlädt

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

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

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

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 Name des Druckertreibers.

portNames: String[]

Die IDs der Anschlüsse, 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

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode (aufgerufen für das LocalPrintServer Objekt, das die Methode von PrintServererbt) verwenden, um einen zweiten Drucker zu installieren, der sich in seinen Eigenschaften von einem vorhandenen Drucker nur an Standort, Port und freigegebenen 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 auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.

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 Name des Druckertreibers.

portNames: String[]

Die IDs der Anschlüsse, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute (als Flags) der neuen Warteschlange.

Gibt zurück

PrintQueue

Der neu erstellte PrintQueue.

Gilt für:

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

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

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 Name des Druckertreibers.

portNames: String[]

Die IDs der Anschlüsse, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute (als Flags) der neuen Warteschlange.

printQueueProperty: PrintQueueStringProperty

Der Kommentar, Speicherort oder Freigabename der neuen Warteschlange.

printQueuePriority: Int32

Ein Wert zwischen 1 und 99, der die Priorität dieser Warteschlange relativ zu anderen Warteschlangen des Druckerservers angibt.

printQueueDefaultPriority: Int32

Ein Wert zwischen 1 und 99, der die Standardpriorität für Druckaufträge angibt, die an die Warteschlange gesendet werden.

Gibt zurück

PrintQueue

Der neu erstellte PrintQueue.

Hinweise

Verwenden Sie den printQueueProperty -Parameter, um eine und nur eine der Eigenschaften , Commentoder Location der Warteschlange ShareNamezu 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 auf dem Druckerserver eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber.

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 Name des Druckertreibers.

portNames: String[]

Die IDs der Anschlüsse, die von der neuen Warteschlange verwendet werden.

printProcessorName: String

Der Name des Druckprozessors.

printQueueAttributes: PrintQueueAttributes

Die Attribute (als Flags) der neuen Warteschlange.

printQueueShareName: String

Der Freigabename der neuen Warteschlange.

printQueueComment: String

Ein Kommentar zur Warteschlange, die für Benutzer auf der Microsoft Windows-Benutzeroberfläche sichtbar ist.

printQueueLocation: String

Der Speicherort der neuen Warteschlange.

printQueueSeparatorFile: String

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

printQueuePriority: Int32

Ein Wert zwischen 1 und 99, der die Priorität der Warteschlange relativ zu anderen Warteschlangen des Druckerservers angibt.

printQueueDefaultPriority: Int32

Ein Wert zwischen 1 und 99, der die Standardpriorität für neue Druckaufträge angibt, die an die Warteschlange gesendet werden.

Gibt zurück

PrintQueue

Der neu erstellte PrintQueue.

Hinweise

Wenn Sie nicht alle drei Eigenschaften, oder Location der Warteschlange ShareName Commentinitialisieren möchten, können Sie eine leere Zeichenfolge für eine oder mehrere von printQueueShareName, printQueueCommentund printQueueLocationübergeben. 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:

Freigeben über

PrintServer.InstallPrintQueue Methode

Definition

Überlädt

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

Parameter

Gibt zurück

Beispiele

Gilt für:

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

Parameter

Gibt zurück

Gilt für:

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

Parameter

Gibt zurück

Hinweise

Gilt für:

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

Parameter

Gibt zurück

Hinweise

Gilt für:

Zusätzliche Ressourcen