SystemTriggerType Enum

Reference

Definition

Namespace:: Windows.ApplicationModel.Background

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

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: Enum
SystemTriggerType

Attributes: ContractVersionAttribute

Windows requirements

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

Fields

Name	Value	Description
Invalid	0	Not a valid trigger type.
SmsReceived	1	The background task is triggered when a new SMS message is received by an installed mobile broadband device.
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.
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.
NetworkStateChange	4	The background task is triggered when a network change occurs, such as a change in cost or connectivity.
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.
InternetAvailable	6	The background task is triggered when the Internet becomes available.
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.
ServicingComplete	8	The background task is triggered when the system has finished updating an app.
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.
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.
OnlineIdConnectedStateChange	12	The background task is triggered when the Microsoft account connected to the account changes.
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.
PowerStateChange	14	The background task is triggered when the status of the battery, BatteryStatus, changes. Note This value was introduced in Windows 10.
DefaultSignInAccountChange	15	The background task is triggered when the default sign-in account changes. Note This value was introduced in Windows 10, version 1607.

Remarks

Version history

Windows version	SDK version	Value added
1607	14393	DefaultSignInAccountChange

Applies to

Share via