PrintServer.InstallPrintQueue Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает очередь печати и связанный с ней драйвер принтера на сервере печати.
Перегрузки
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Устанавливает общую приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)
Устанавливает очередь печати и связанный драйвер принтера на сервере печати.
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 PrintQueueПараметры
- printQueueName
- String
Имя новой очереди.
- driverName
- String
Путь к драйверу принтера и его имя.
- portNames
- String[]
Идентификаторы портов, используемых новой очередью.
- printProcessorName
- String
Имя обработчика заданий печати.
- initialParameters
- PrintPropertyDictionary
Инициализированные параметры.
Возвращаемое значение
Новый объект PrintQueue.
Примеры
В следующем примере показано, как использовать этот метод (вызываемый для LocalPrintServer объекта, наследующего метод от PrintServer) для установки второго принтера, который отличается по своим свойствам от существующего принтера только по расположению, порту и общему состоянию.
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()
Применяется к
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)
Устанавливает очередь печати и связанный драйвер принтера на сервере печати.
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 PrintQueueПараметры
- printQueueName
- String
Имя новой очереди.
- driverName
- String
Путь к драйверу принтера и его имя.
- portNames
- String[]
Идентификаторы портов, используемых новой очередью.
- printProcessorName
- String
Имя обработчика заданий печати.
- printQueueAttributes
- PrintQueueAttributes
Атрибуты новой очереди, например флаги.
Возвращаемое значение
Вновь созданный PrintQueue.
Применяется к
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати.
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 PrintQueueПараметры
- printQueueName
- String
Имя новой очереди.
- driverName
- String
Путь к драйверу принтера и его имя.
- portNames
- String[]
Идентификаторы портов, используемых новой очередью.
- printProcessorName
- String
Имя обработчика заданий печати.
- printQueueAttributes
- PrintQueueAttributes
Атрибуты новой очереди, например флаги.
- printQueueProperty
- PrintQueueStringProperty
Примечание, расположение или совместно используемое имя новой очереди.
- printQueuePriority
- Int32
Значение от 1 до 99, которое указывает приоритет данной очереди печати по отношению к другим очередям, размещенным на сервере печати.
- printQueueDefaultPriority
- Int32
Значение от 1 до 99, которое указывает приоритет по умолчанию заданий печати, отправленных в очередь.
Возвращаемое значение
Вновь созданный PrintQueue.
Комментарии
Используйте параметр для инициализации printQueueProperty одного и только одного свойства очереди ShareName, Commentили Location . Если вы хотите инициализировать несколько, используйте перегрузку InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) этого метода.
Применяется к
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)
Устанавливает общую приоритетную очередь печати и связанный драйвер принтера на сервере печати.
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 PrintQueueПараметры
- printQueueName
- String
Имя новой очереди.
- driverName
- String
Путь к драйверу принтера и его имя.
- portNames
- String[]
Идентификаторы портов, используемых новой очередью.
- printProcessorName
- String
Имя обработчика заданий печати.
- printQueueAttributes
- PrintQueueAttributes
Атрибуты новой очереди, например флаги.
- printQueueShareName
- String
Совместно используемое имя новой очереди.
- printQueueComment
- String
Комментарий к очереди, видимый пользователям в пользовательском интерфейсе Windows Майкрософт.
- printQueueLocation
- String
Расположение новой очереди.
- printQueueSeparatorFile
- String
Путь к файлу, который добавляется в начале каждого задания печати.
- printQueuePriority
- Int32
Значение от 1 до 99, которое указывает приоритет очереди печати по отношению к другим очередям, размещенным на сервере печати.
- printQueueDefaultPriority
- Int32
Значение от 1 до 99, которое указывает приоритет по умолчанию новых заданий печати, отправленных в очередь.
Возвращаемое значение
Вновь созданный PrintQueue.
Комментарии
Если вы не хотите инициализировать все три свойства очереди ShareName, или Location , Commentможно передать пустую строку для одного или нескольких из printQueueShareName, printQueueCommentи printQueueLocation. Если вы хотите инициализировать только одно из этих свойств, используйте перегрузку InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) этого метода.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по