SystemSetting enumeration

Specifies the type of system settings to retrieve or set.

Syntax

enum SystemSetting {
  SystemSettingNone                       = 0, 
  SystemSettingFlagGetBool                = 65536,                                                                                          // 0x10000
  SystemSettingFlagSetBoolFalse           = 16777216,                                                                                       // 0x1000000
  SystemSettingFlagSetBoolTrue            = 33554432,                                                                                       // 0x2000000
  SystemSettingBatteryPresent             = 1 | SystemSettingFlagGetBool, 
  SystemSettingOnACPower                  = 2 | SystemSettingFlagGetBool, 
  SystemSettingElevated                   = 3 | SystemSettingFlagGetBool, 
  SystemSettingPioModeOnSystemDrive       = 4 | SystemSettingFlagGetBool, 
  SystemSettingUsingBasicDisplay          = 5 | SystemSettingFlagGetBool, 
  SystemSettingIEPresent                  = 6 | SystemSettingFlagGetBool, 
  SystemSettingAutoLogOnEnabled           = 7 | SystemSettingFlagGetBool, 
  SystemSettingAntivirusActive            = 8 | SystemSettingFlagGetBool, 
  SystemSettingKernelDebuggerEnabled      = 9 | SystemSettingFlagGetBool, 
  SystemSettingDriverVerifierEnabled      = 10 | SystemSettingFlagGetBool, 
  SystemSettingProblemDevicesExist        = 11 | SystemSettingFlagGetBool, 
  SystemSettingPowerProfileMinSavings     = 12 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolTrue, 
  SystemSettingPowerProfileBalanced       = 13 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolTrue, 
  SystemSettingPowerProfileMaxSavings     = 14 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolTrue, 
  SystemSettingLowBatteryAction           = 15 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingScreensaver                = 16 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingCriticalBatteryAction      = 17 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingAutoSleepAC                = 18 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingAutoSleepDC                = 19 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingAutoHibernateAC            = 20 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingAutoHibernateDC            = 21 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingDisplayTimeoutAC           = 22 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingDisplayTimeoutDC           = 23 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingDisplayDimAC               = 24 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingDisplayDimDC               = 25 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingVolumeShadowCopy           = 26 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingWindowsAutoUpdate          = 27 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingWirelessAdaptersConnected  = 28 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingLockOnWakeAC               = 29 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingLockOnWakeDC               = 30 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse, 
  SystemSettingWakeOnTimerAC              = 31 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingWakeOnTimerDC              = 32 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingHibernateOn                = 33 | SystemSettingFlagGetBool, 
  SystemSettingSuspendOn                  = 34 | SystemSettingFlagGetBool, 
  SystemSettingFastStartupOn              = 35 | SystemSettingFlagGetBool, 
  SystemSettingShowExtensions             = 36 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingShowAllObjects             = 37 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingScreenBackground           = 38 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingIEFirstRun                 = 39 | SystemSettingFlagSetBoolFalse, 
  SystemSettingScreensaverSecure          = 40 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingTracingRunning             = 41 | SystemSettingFlagGetBool, 
  SystemSettingAudioRenderDevicePresent   = 42 | SystemSettingFlagGetBool, 
  SystemSettingDisplayBootMenu            = 43 | SystemSettingFlagGetBool, 
  SystemSettingConnectedStandbyOn         = 44 | SystemSettingFlagGetBool, 
  SystemSettingAllowDisplayRequiredAC     = 45 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingAllowDisplayRequiredDC     = 46 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingAllowExecutionRequiredAC   = 47  | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingAllowExecutionRequiredDC   = 48  | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingIEWarnOnIntranet           = 49  | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue, 
  SystemSettingLockScreen                 = 50 | SystemSettingFlagGetBool | SystemSettingFlagSetBoolFalse | SystemSettingFlagSetBoolTrue 

};

Constants

SystemSettingNone

No system setting was specified. This value should never occur at runtime.

SystemSettingFlagGetBool

A flag that specifies that a SystemSetting enumerator is readable.

SystemSettingFlagSetBoolFalse

A flag that indicates that a SystemSetting enumerator is writable with the value of false.

SystemSettingFlagSetBoolTrue

A flag that indicates that a SystemSetting enumerator is writable with the value of true.

SystemSettingBatteryPresent

A battery is present in the system.

SystemSettingOnACPower

The system is on AC power.

SystemSettingElevated

TThe assessment is running elevated.

SystemSettingPioModeOnSystemDrive

The system drive is using PIO mode.

SystemSettingUsingBasicDisplay

The system is using the basic display driver.

SystemSettingIEPresent

Internet Explorer is present in the installed OS SKU.

SystemSettingAutoLogOnEnabled

Auto Logon is enabled.

SystemSettingAntivirusActive

An anti-virus application is active.

SystemSettingKernelDebuggerEnabled

A kernel debugger is enabled on the system.

SystemSettingDriverVerifierEnabled

Driver Verifier is enabled on the system.

SystemSettingProblemDevicesExist

One or more devices have an issue. In Device Manager, these devices are shown with a yellow bang icon.

SystemSettingPowerProfileMinSavings

The current power profile is set to minimum power savings.

SystemSettingPowerProfileBalanced

The current power profile is set to balanced power savings.

SystemSettingPowerProfileMaxSavings

The current power profile is set to maximum power savings.

SystemSettingLowBatteryAction

The low battery action is enabled.

SystemSettingScreensaver

The screen saver has a non-zero timeout and will activate when the timer expires.

SystemSettingCriticalBatteryAction

The critical battery action is enabled.

SystemSettingAutoSleepAC

The system has a non-zero timeout value for going to sleep when on AC power.

SystemSettingAutoSleepDC

The system has a non-zero timeout value for going to sleep when on DC power.

SystemSettingAutoHibernateAC

The system has a non-zero timeout value for hibernating when on AC power.

SystemSettingAutoHibernateDC

The system has a non-zero timeout value for hibernating when on DC power.

SystemSettingDisplayTimeoutAC

The system has a non-zero timeout for when the display will turn off when on AC power.

SystemSettingDisplayTimeoutDC

The system has a non-zero timeout for when the display will turn off when on DC power.

SystemSettingDisplayDimAC

The system has a non-zero timeout for when the display will dim while on AC power.

SystemSettingDisplayDimDC

The system has a non-zero timeout for when the display will dim while on DC power.

SystemSettingVolumeShadowCopy

The Volume Shadow Copy service is enabled.

SystemSettingWindowsAutoUpdate

Windows Update will automatically update the system.

SystemSettingWirelessAdaptersConnected

Wireless networking adapters are enabled and connected to a wireless network.

SystemSettingLockOnWakeAC

The system will prompt for a password when it wakes from sleep or hibernation while on AC power.

SystemSettingLockOnWakeDC

The system will prompt for a password when it wakes from sleep or hibernation while on DC power.

SystemSettingWakeOnTimerAC

The Wake Timer has a non-zero value while on AC power.

SystemSettingWakeOnTimerDC

The Wake Timer has a non-zero value while on DC power.

SystemSettingHibernateOn

The system has a non-zero timeout value for hibernating.

SystemSettingSuspendOn

The system under assessment is enabled for suspension.

SystemSettingFastStartupOn

The system under assessment is enabled for Fast Startup (hybrid boot).

SystemSettingShowExtensions

The File Explorer option to show extensions is enabled.

SystemSettingShowAllObjects

The File Explorer option to show hidden items is enabled.

SystemSettingScreenBackground

The system under assessment is set to display a desktop background.

SystemSettingIEFirstRun

Internet Explorer behaves as it does when it runs for the first time

SystemSettingScreensaverSecure

The system under assessment displays the logon screen after it returns from a screen saver.

SystemSettingTracingRunning

A Windows Performance Record trace is running.

SystemSettingAudioRenderDevicePresent

An audio rendering device (for example, speakers) is present.

SystemSettingDisplayBootMenu

The system displays a menu when it boots, for example when multiple operating systems are installed.

SystemSettingConnectedStandbyOn

The system supports connected standby mode.

SystemSettingAllowDisplayRequiredAC

The system when on AC power allows the display to be required (the display won't turn off).

SystemSettingAllowDisplayRequiredDC

The system when on DC power allows the display to be required (the display won't turn off).

SystemSettingAllowExecutionRequiredAC

The system when on AC power allows an execution required request (the system won't suspend if execution required is set).

SystemSettingAllowExecutionRequiredDC

The system when on DC power allows an execution required request (the system won't suspend if execution required is set).

SystemSettingIEWarnOnIntranet

Internet Explorer warns if the Intranet security settings are in effect.

SystemSettingLockScreen

The lock screen is displayed after a suspend.

Remarks

Assessments can query the system for various settings using the SystemSettingCheckBoolean API or the SystemState interface. Only some of the system settings are writable to false and some are writable to true.

Managed code uses the SystemSetting enum.

Requirements