SetDefaultPrinter method of the Win32_Printer class

The SetDefaultPrinter WMI class method sets the default system printer for the user calling the method.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

uint32 SetDefaultPrinter();

Parameters

This method has no parameters.

Return value

Returns 0 (zero) if successful, and some other value if an error occurs. For additional error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Examples

The Install a TCP/IP Printer Port and Printer VBScript sample installs a TCP/IP printer port, installs a printer, and then sets the printer to be default.

The following VBScript code sample sets the default printer on a computer.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colInstalledPrinters =  objWMIService.ExecQuery _ 
    ("Select * from Win32_Printer Where Name = 'ScriptedPrinter'") 
 
For Each objPrinter in colInstalledPrinters 
    objPrinter.SetDefaultPrinter() 
Next 

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

WMI Tasks: Printers and Printing

Win32_Printer