System​Trigger​Type System​Trigger​Type System​Trigger​Type Enum

Definition

Specifies the system events that can be used to trigger a background task.

public enum SystemTriggerTypepublic enum SystemTriggerTypePublic Enum SystemTriggerType
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Fields

BackgroundWorkCostChange BackgroundWorkCostChange BackgroundWorkCostChange

The background task is triggered when the cost of background work changes.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10, Windows Server 2016, Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

ControlChannelReset ControlChannelReset ControlChannelReset

The background task is triggered when a control channel is reset.

Note

This trigger type does not support a OneShot mode. So the OneShot parameter must be false when using the SystemTrigger constructor.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10, Windows Server 2016, Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

DefaultSignInAccountChange DefaultSignInAccountChange DefaultSignInAccountChange

The background task is triggered when the default sign-in account changes.

Note

This value was introduced in Windows 10, version 1607.

InternetAvailable InternetAvailable InternetAvailable

The background task is triggered when the Internet becomes available.

Invalid Invalid Invalid

Not a valid trigger type.

LockScreenApplicationAdded LockScreenApplicationAdded LockScreenApplicationAdded

The background task is triggered when a tile is added to the lock screen.

LockScreenApplicationRemoved LockScreenApplicationRemoved LockScreenApplicationRemoved

The background task is triggered when a tile is removed from the lock screen.

NetworkStateChange NetworkStateChange NetworkStateChange

The background task is triggered when a network change occurs, such as a change in cost or connectivity.

OnlineIdConnectedStateChange OnlineIdConnectedStateChange OnlineIdConnectedStateChange

The background task is triggered when the Microsoft account connected to the account changes.

PowerStateChange PowerStateChange PowerStateChange

The background task is triggered when the status of the battery, BatteryStatus, changes.

Note

This value was introduced in Windows 10.

ServicingComplete ServicingComplete ServicingComplete

The background task is triggered when the system has finished updating an app.

SessionConnected SessionConnected SessionConnected

The background task is triggered when the session is connected.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10, Windows Server 2016, Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

SmsReceived SmsReceived SmsReceived

The background task is triggered when a new SMS message is received by an installed mobile broadband device.

TimeZoneChange TimeZoneChange TimeZoneChange

The background task is triggered when the time zone changes on the device (for example, when the system adjusts the clock for daylight saving time).

Note

This trigger only fires if the new time zone actually changes the system time.

UserAway UserAway UserAway

The background task is triggered when the user becomes absent.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10, Windows Server 2016, Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

UserPresent UserPresent UserPresent

The background task is triggered when the user becomes present.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10, Windows Server 2016, Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.