Adds a Windows-based printer connection to your computer system.
Windows NT/2000: object.AddWindowsPrinterConnection( strPrinterPath ) |
Windows 9x/Me: object.AddWindowsPrinterConnection( strPrinterPath, strDriverName[,strPort] ) |
Arguments
- object
-
WshNetwork object.
- strPrinterPath
-
String value indicating the path to the printer connection.
- strDriverName
-
String value indicating the name of the driver (ignored if used on Windows NT/Windows 2000).
- strPort
-
Optional. String value specifying a printer port for the printer connection (ignored on Windows NT/Windows 2000).
Remarks
Using this method is similar to using the Printer option on Control Panel to add a printer connection. Unlike the AddPrinterConnection method, this method allows you to create a printer connection without directing it to a specific port, such as LPT1. If the connection fails, an error is thrown. In Windows 9x/Me, the printer driver must already be installed on the machine for the AddWindowsPrinterConnection method to work. If the driver is not installed, Windows returns an error message.
Example 1
The following code uses the AddWindowsPrinterConnection method to connect a network printer to a Windows NT/2000 computer system.
Visual Basic Script | Copy Code |
---|---|
Set WshNetwork = WScript.CreateObject("WScript.Network") PrinterPath = "\\printserv\DefaultPrinter" WshNetwork.AddWindowsPrinterConnection PrinterPath |
JScript | Copy Code |
---|---|
var WshNetwork = WScript.CreateObject("WScript.Network"); var PrinterPath = "\\\\printserv\\DefaultPrinter"; WshNetwork.AddWindowsPrinterConnection(PrinterPath); |
Example 2
The following code uses the AddWindowsPrinterConnection method to connect a network printer to a Windows 9x/Me computer system.
Visual Basic Script | Copy Code |
---|---|
Set WshNetwork = WScript.CreateObject("WScript.Network") PrinterPath = "\\printserv\DefaultPrinter" PrinterDriver = "Lexmark Optra S 1650" WshNetwork.AddWindowsPrinterConnection PrinterPath, PrinterDriver |
JScript | Copy Code |
---|---|
var WshNetwork = WScript.CreateObject("WScript.Network"); var PrinterPath = "\\\\printserv\\DefaultPrinter"; var PrinterDriver = "Lexmark Optra S 1650"; WshNetwork.AddWindowsPrinterConnection(PrinterPath, PrinterDriver); |