PrintServer.InstallPrintQueue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Instala una cola de impresión y su controlador de impresora asociado, en el servidor de impresión.
Sobrecargas
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Instala una cola de impresión con prioridad, y su controlador de impresora asociado, en el servidor de impresión. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Instala una cola de impresión con prioridad y compartida, y su controlador de impresora asociado, en el servidor de impresión. |
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)
Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.
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.PrintQueuePublic Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, initialParameters As PrintPropertyDictionary) As PrintQueueParámetros
- printQueueName
- String
Nombre de la nueva cola.
- driverName
- String
Ruta de acceso y nombre del controlador de impresora.
- portNames
- String[]
Identificadores de los puertos que la nueva cola utiliza.
- printProcessorName
- String
Nombre del procesador de impresión.
- initialParameters
- PrintPropertyDictionary
Parámetros que se inicializan.
Devoluciones
Nuevo objeto PrintQueue.
Ejemplos
En el ejemplo siguiente se muestra cómo usar este método (denominado en el LocalPrintServer objeto que hereda el método de PrintServer) para instalar una segunda impresora que difiere en sus propiedades de una impresora existente solo en la ubicación, el puerto y el estado compartido.
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()
Se aplica a
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)
Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.
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.PrintQueuePublic Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes) As PrintQueueParámetros
- printQueueName
- String
Nombre de la nueva cola.
- driverName
- String
Ruta de acceso y nombre del controlador de impresora.
- portNames
- String[]
Identificadores de los puertos que la nueva cola utiliza.
- printProcessorName
- String
Nombre del procesador de impresión.
- printQueueAttributes
- PrintQueueAttributes
Atributos, como marcadores, de la nueva cola.
Devoluciones
Colección PrintQueue creada recientemente.
Se aplica a
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)
Instala una cola de impresión con prioridad, y su controlador de impresora asociado, en el servidor de impresión.
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.PrintQueuePublic 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 PrintQueueParámetros
- printQueueName
- String
Nombre de la nueva cola.
- driverName
- String
Ruta de acceso y nombre del controlador de impresora.
- portNames
- String[]
Identificadores de los puertos que la nueva cola utiliza.
- printProcessorName
- String
Nombre del procesador de impresión.
- printQueueAttributes
- PrintQueueAttributes
Atributos, como marcadores, de la nueva cola.
- printQueueProperty
- PrintQueueStringProperty
Comentario, ubicación o nombre del recurso compartido de la nueva cola.
- printQueuePriority
- Int32
Valor de 1 a 99 que especifica la prioridad de esta cola de impresión relativa a otras colas que se hospedan en el servidor de impresión.
- printQueueDefaultPriority
- Int32
Valor de 1 a 99 que especifica la prioridad predeterminada de los trabajos de impresión que se envían a la cola.
Devoluciones
Colección PrintQueue creada recientemente.
Comentarios
Use el printQueueProperty parámetro para inicializar uno y solo uno de las propiedades , Commento Location de la colaShareName. Si desea inicializar más de uno, use la InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) sobrecarga de este método.
Se aplica a
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)
Instala una cola de impresión con prioridad y compartida, y su controlador de impresora asociado, en el servidor de impresión.
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.PrintQueuePublic 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 PrintQueueParámetros
- printQueueName
- String
Nombre de la nueva cola.
- driverName
- String
Ruta de acceso y nombre del controlador de impresora.
- portNames
- String[]
Identificadores de los puertos que la nueva cola utiliza.
- printProcessorName
- String
Nombre del procesador de impresión.
- printQueueAttributes
- PrintQueueAttributes
Atributos, como marcadores, de la nueva cola.
- printQueueShareName
- String
Nombre del recurso compartido de la nueva cola.
- printQueueComment
- String
Comentario sobre la cola que es visible para los usuarios en la interfaz de usuario de Microsoft Windows.
- printQueueLocation
- String
Ubicación de la nueva cola.
- printQueueSeparatorFile
- String
Ruta de acceso de un archivo que se inserta al principio de cada trabajo de impresión.
- printQueuePriority
- Int32
Valor de 1 a 99 que especifica la prioridad de la cola relativa a otras colas que se hospedan en el servidor de impresión.
- printQueueDefaultPriority
- Int32
Valor de 1 a 99 que especifica la prioridad predeterminada de los nuevos trabajos de impresión que se envían a la cola.
Devoluciones
Colección PrintQueue creada recientemente.
Comentarios
Si no desea inicializar las tres propiedades , o de la colaShareName; puede pasar una cadena vacía para uno o varios de printQueueShareName, printQueueCommenty printQueueLocation.LocationComment Si desea inicializar solo una de estas propiedades, use la InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) sobrecarga de este método.
