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

 

 

Show: