Compartilhar via


PrintServer.InstallPrintQueue Método

Definição

Instala uma fila de impressão e seu driver de impressora associado no servidor de impressão.

Sobrecargas

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

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

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

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

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

Instala uma fila de impressão priorizada e o driver de impressão associado, no servidor de impressão.

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

Instala uma fila de impressão priorizada compartilhada e o driver de impressão associado, no servidor de impressão.

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

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

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

Parâmetros

printQueueName
String

O nome da nova fila.

driverName
String

O caminho e o nome do driver de impressora.

portNames
String[]

As IDs das portas que a nova fila usa.

printProcessorName
String

O nome do processador de impressão.

initialParameters
PrintPropertyDictionary

Os parâmetros que são inicializados.

Retornos

O novo PrintQueue.

Exemplos

O exemplo a seguir mostra como usar esse método (chamado no LocalPrintServer objeto que herda o método de PrintServer) para instalar uma segunda impressora que difere em suas propriedades de uma impressora existente apenas em localização, porta e status compartilhadas.

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

Aplica-se a

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

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

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

Parâmetros

printQueueName
String

O nome da nova fila.

driverName
String

O caminho e o nome do driver de impressora.

portNames
String[]

As IDs das portas que a nova fila usa.

printProcessorName
String

O nome do processador de impressão.

printQueueAttributes
PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

Retornos

O PrintQueue recém-criado.

Aplica-se a

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

Instala uma fila de impressão priorizada e o driver de impressão associado, no servidor de impressão.

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

Parâmetros

printQueueName
String

O nome da nova fila.

driverName
String

O caminho e o nome do driver de impressora.

portNames
String[]

As IDs das portas que a nova fila usa.

printProcessorName
String

O nome do processador de impressão.

printQueueAttributes
PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

printQueueProperty
PrintQueueStringProperty

O comentário, o local ou o nome do compartilhamento da nova fila.

printQueuePriority
Int32

Um valor de 1 a 99 que especifica a prioridade dessa fila de impressão em relação a outras filas hospedadas pelo servidor de impressão.

printQueueDefaultPriority
Int32

Um valor de 1 a 99 que especifica a prioridade padrão dos trabalhos de impressão que são enviados para a fila.

Retornos

O PrintQueue recém-criado.

Comentários

Use o printQueueProperty parâmetro para inicializar um e apenas um das propriedades , Commentou Location da ShareNamefila. Se você quiser inicializar mais de um, use a InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) sobrecarga desse método.

Aplica-se a

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

Instala uma fila de impressão priorizada compartilhada e o driver de impressão associado, no servidor de impressão.

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

Parâmetros

printQueueName
String

O nome da nova fila.

driverName
String

O caminho e o nome do driver de impressora.

portNames
String[]

As IDs das portas que a nova fila usa.

printProcessorName
String

O nome do processador de impressão.

printQueueAttributes
PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

printQueueShareName
String

O nome do compartilhamento da nova fila.

printQueueComment
String

Um comentário sobre a fila visível para os usuários na interface do usuário do Microsoft Windows.

printQueueLocation
String

O local da nova fila.

printQueueSeparatorFile
String

O caminho de um arquivo que é inserido no início de cada trabalho de impressão.

printQueuePriority
Int32

Um valor de 1 a 99 que especifica a prioridade da fila em relação a outras filas hospedadas pelo servidor de impressão.

printQueueDefaultPriority
Int32

Um valor de 1 a 99 que especifica a prioridade padrão dos novos trabalhos de impressão que são enviados para a fila.

Retornos

O PrintQueue recém-criado.

Comentários

Se você não quiser inicializar todas as três propriedades , ou Location da ShareNameCommentfila, poderá passar uma cadeia de caracteres vazia para um ou mais de printQueueShareName, printQueueCommente printQueueLocation. Se você quiser inicializar apenas uma dessas propriedades, use a InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) sobrecarga desse método.

Aplica-se a