SystemTriggerType Enum

Definition

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

public enum class SystemTriggerType
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class SystemTriggerType
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum SystemTriggerType
var value = Windows.ApplicationModel.Background.SystemTriggerType.invalid
Public Enum SystemTriggerType
Inheritance
SystemTriggerType
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

BackgroundWorkCostChange 13

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 5

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 15

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

Note

This value was introduced in Windows 10, version 1607.

InternetAvailable 6

The background task is triggered when the Internet becomes available.

Invalid 0

Not a valid trigger type.

LockScreenApplicationAdded 9

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

LockScreenApplicationRemoved 10

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

NetworkStateChange 4

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

OnlineIdConnectedStateChange 12

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

PowerStateChange 14

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

Note

This value was introduced in Windows 10.

ServicingComplete 8

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

SessionConnected 7

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 1

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

TimeZoneChange 11

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 3

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 2

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.

Remarks

Version history

Windows version SDK version Value added
1607 14393 DefaultSignInAccountChange

Applies to

See also