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

 

 

Show: