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 can not 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

TheInstall a Printer Driver not Found in Drivers Cab VBScript code example installs a hypothetical printer using a print driver not found in Drivers.cab.

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

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
Win32_Printer.mof
DLL
CIMWin32.dll

See also

Computer System Hardware Classes

Win32_PrinterDriver