Win32_Desktop class

The Win32_DesktopWMI class represents the common characteristics of a user's desktop. The properties of this class can be modified by the user to customize the desktop.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4E3-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Desktop : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  uint32  BorderWidth;
  boolean CoolSwitch;
  uint32  CursorBlinkRate;
  boolean DragFullWindows;
  uint32  GridGranularity;
  uint32  IconSpacing;
  string  IconTitleFaceName;
  uint32  IconTitleSize;
  boolean IconTitleWrap;
  string  Name;
  string  Pattern;
  boolean ScreenSaverActive;
  string  ScreenSaverExecutable;
  boolean ScreenSaverSecure;
  uint32  ScreenSaverTimeout;
  string  Wallpaper;
  boolean WallpaperStretched;
  boolean WallpaperTiled;
};

Members

The Win32_Desktop class has these types of members:

Properties

The Win32_Desktop class has these properties.

BorderWidth
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop\\WindowMetrics|BorderWidth")

Width of the borders around all windows with adjustable borders.

Example: 3

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

Short textual description of the current object.

This property is inherited from CIM_Setting.

CoolSwitch
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|Control Panel\\Desktop|CoolSwitch")

Fast task switching is turned on. Fast task switching allows the user to switch between windows using the ALT+TAB keyboard combination.

CursorBlinkRate
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|Control Panel\\Desktop|CursorBlinkRate"), Units ("milliseconds")

Length of time between successive cursor blinks.

Example: 530

Description
Data type: string
Access type: Read-only

Textual description of the current object.

This property is inherited from CIM_Setting.

DragFullWindows
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|Control Panel\\Desktop|DragFullWindows")

Contents of a window are shown when a user moves the window.

GridGranularity
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|Control Panel\\Desktop|GridGranularity"), Units ("8 pixels")

Spacing of the grid that windows are bound to on the desktop. This makes organizing windows easier. The spacing is usually fine enough that the user does not notice it.

Example: 1

IconSpacing
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop\\WindowMetrics|IconSpacing"), Units ("pixels")

Spacing between icons.

Example: 75

IconTitleFaceName
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop\\WindowMetrics|IconFont")

Font used for the names of the icons.

Example: "MS San Serif"

IconTitleSize
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32API|Font and Text Structures|LOGFONTW|lfHeight"), Units ("point")

Icon font size.

Example: 9

IconTitleWrap
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop\\WindowMetrics|IconTitleWrap")

Icon's title text wraps to the next line.

Name
Data type: string
Access type: Read-only
Qualifiers: key, MappingStrings ("WMI")

Name that identifies the current desktop profile.

Example: "MainProf"

Pattern
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|Pattern")

Name of the pattern used as the background for the desktop.

ScreenSaverActive
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|ScreenSaveActive")

Screen saver is active.

ScreenSaverExecutable
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|SCRNSAVE.EXE")

Name of the current screen saver executable file.

Example: "LOGON.SCR"

ScreenSaverSecure
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|ScreenSaverIsSecure")

Password is enabled for the screen saver.

ScreenSaverTimeout
Data type: uint32
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|ScreenSaveTimeOut"), Units ("seconds")

Amount of time that passes before the screen saver starts.

SettingID
Data type: string
Access type: Read-only
Qualifiers: MaxLen (256)

Identifier by which the current object is known.

This property is inherited from CIM_Setting.

Wallpaper
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|Wallpaper")

File name for the wallpaper design on the background of the desktop.

Example: "WINNT.BMP"

WallpaperStretched
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|WallpaperStyle")

Wallpaper is stretched to fill the entire screen. Microsoft Plus! must be installed before this option is available. If FALSE, the wallpaper retains its original dimensions on the desktop background.

WallpaperTiled
Data type: boolean
Access type: Read-only
Qualifiers: MappingStrings ("Win32Registry|.DEFAULT\\Control Panel\\Desktop|TileWallpaper")

Wallpaper is tiled or centered.

Remarks

The Win32_Desktop class is derived from CIM_Setting.

The calling process that uses this class must have the SE_RESTORE_NAME privilege on the computer in which the registry resides. For example, if you enumerate this class on the local computer, the account under which your application runs must have this privilege. For more information, see Executing Privileged Operations.

Examples

The following code sample describes how to retrieve desktop information.



$desktops = Get-WmiObject win32_desktop

"This system has {0} desktop objects" -f $desktops.length
Foreach ($dt in $desktops) {
"Desktop {0}" -f $i++
"  BorderWidth           : {0}" -f $dt.BorderWidth 
"  Caption               : {0}" -f $dt.Caption
"  CoolSwitch            : {0}" -f $dt.CoolSwitch
"  CursorBlinkRate       : {0}" -f $dt.CursorBlinkRate
"  Description           : {0}" -f $dt.Description 
"  DragFullWindows       : {0}" -f $dt.DragFullWindows
"  GridGranularity       : {0}" -f $dt.GridGranularity 
"  IconSpacing           : {0}" -f $dt.IconSpacing
"  IconTitleFaceName     : {0}" -f $dt.IconTitleFaceName
"  IconTitleSize         : {0}" -f $dt.IconTitleSize
"  IconTitleWrap         : {0}" -f $dt.conTitleWrap
"  Name                  : {0}" -f $dt.Name
"  Pattern               : {0}" -f $dt.Pattern 
"  ScreenSaverActive     : {0}" -f $dt.ScreenSaverActive
"  ScreenSaverExecutable : {0}" -f $dt.ScreenSaverExecutable
"  ScreenSaverSecure     : {0}" -f $dt.creenSaverSecure
"  ScreenSaverTimeout    : {0}" -f $dt.ScreenSaverTimeout
"  SettingID             : {0}" -f $dt.SettingID
"  Wallpaper             : {0}" -f $dt.Wallpaper
"  WallpaperStretched    : {0}" -f $dt.WallpaperStretched
"  WallpaperTiled        : {0}" -f $dt.WallpaperTiled
""
}


Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

CIM_Setting
Operating System Classes

 

 

Show: