Freigeben über


PrintServer.InstallPrintQueue Methode

Definition

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

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

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

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

Der neu erstellte PrintQueue.

Hinweise

Wenn Sie nicht alle drei Eigenschaften, oder Location der Warteschlange ShareNameCommentinitialisieren 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: