AddPrinterDriver method of the Win32_PrinterDriver class
The AddPrinterDriver class method creates a new printer driver.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.
Syntax
uint32 AddPrinterDriver(
[in] Win32_PrinterDriver DriverInfo
);
Parameters
-
DriverInfo [in]
-
An instance of the Win32_PrinterDriver class that represents the printer driver.
Return value
Returns one of the values listed in the following list or any other value to indicate an error. For values different from those listed in the following list, see WMI Error Constants.
-
0
-
Success.
-
5
-
Access denied.
-
87
-
The parameter is incorrect. May occur when the object is not correctly filled or when driver cannot be found in the system. Alternately, the name attribute may be different than the model specified in the .inf file. Or, there may be a missing backslash ("\") on a PathFile attribute.
-
1797
-
The printer driver is unknown.
Remarks
Note
When using the AddPrinterDriver method you must use SeLoadDriverPrivilege to load or unload a device driver.
Examples
The following VBScript sample installs the printer driver for an Apple LaserWriter 8500 printer.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
objWMIService.Security_.Privileges.AddAsString "SeLoadDriverPrivilege", True
Set objDriver = objWMIService.Get("Win32_PrinterDriver")
objDriver.Name = "NewPrinter Model 2900"
objDriver.SupportedPlatform = "Windows NT x86"
objDriver.Version = "3"
objDriver.DriverPath = "C:\Scripts\NewPrinter.dll"
objDriver.Infname = "C:\Scripts\NewPrinter.inf"
intResult = objDriver.AddPrinterDriver(objDriver)
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|