PrintServer.InstallPrintQueue メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
印刷キューと関連プリンター ドライバーをプリント サーバーにインストールします。
オーバーロード
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.PrintQueue
Public 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[]
新しいキューが使用するポートの ID。
- printProcessorName
- String
プリント プロセッサの名前。
- initialParameters
- PrintPropertyDictionary
初期化されるパラメーター。
戻り値
新しい PrintQueue。
例
次の例では、このメソッド (メソッドを継承PrintServerする オブジェクトで LocalPrintServer 呼び出されます) を使用して、場所、ポート、および共有状態でのみ、そのプロパティと既存のプリンターと異なる 2 番目のプリンターをインストールする方法を示します。
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.PrintQueue
Public 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[]
新しいキューが使用するポートの ID。
- 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.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
パラメーター
- printQueueName
- String
新しいキューの名前。
- driverName
- String
プリンター ドライバーのパスおよび名前。
- portNames
- String[]
新しいキューが使用するポートの ID。
- printProcessorName
- String
プリント プロセッサの名前。
- printQueueAttributes
- PrintQueueAttributes
新しいキューの、フラグとしての属性。
- printQueueProperty
- PrintQueueStringProperty
新しいキューのコメント、位置、または共有名。
- printQueuePriority
- Int32
プリント サーバーでホストされている他のキューに対して、この印刷キューの優先順位を指定する 1 ~ 99 の値。
- printQueueDefaultPriority
- Int32
キューに送信される印刷ジョブの既定の優先順位を指定する 1 ~ 99 の値。
戻り値
新しく作成された PrintQueue。
注釈
パラメーターをprintQueueProperty
使用して、キューShareNameCommentの 、、または Location プロパティの 1 つだけを初期化します。 複数のを初期化する場合は、このメソッドのオーバーロードを 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.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
パラメーター
- printQueueName
- String
新しいキューの名前。
- driverName
- String
プリンター ドライバーのパスおよび名前。
- portNames
- String[]
新しいキューが使用するポートの ID。
- printProcessorName
- String
プリント プロセッサの名前。
- printQueueAttributes
- PrintQueueAttributes
新しいキューの、フラグとしての属性。
- printQueueShareName
- String
新しいキューの共有名。
- printQueueComment
- String
Microsoft Windows UI でユーザーに表示されるキューに関するコメント。
- printQueueLocation
- String
新しキューの位置。
- printQueueSeparatorFile
- String
各印刷ジョブの先頭に挿入されるファイルのパス。
- printQueuePriority
- Int32
プリント サーバーでホストされている他のキューに対して、このキューの優先順位を指定する 1 ~ 99 の値。
- printQueueDefaultPriority
- Int32
キューに送信される新しい印刷ジョブの既定の優先順位を指定する 1 ~ 99 の値。
戻り値
新しく作成された PrintQueue。
注釈
キューの 、、Commentまたは プロパティの 3 つすべてを初期化しない場合はShareName、1 つ以上の 、printQueueComment
、および printQueueLocation
に空のprintQueueShareName
文字列を渡Locationすことができます。 これらのプロパティのいずれかを初期化する場合は、このメソッドのオーバーロードを InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) 使用します。
適用対象
.NET