AddPrinterDriver method of the Win32_PrinterDriver class

Article
11/09/2023

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	Win32_Printer.mof
DLL	CIMWin32.dll