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
| Minimum supported client |
Windows 7 [desktop apps only] |
| Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
| Header |
|