Windows Dev Center

SystemTriggerType enumeration

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

Syntax


public enum class SystemTriggerType

Attributes

[Version(0x06020000)]

Members

The SystemTriggerType enumeration has these members.

MemberValueDescription
Invalid | invalid0

Not a valid trigger type.

SmsReceived | smsReceived1

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

UserPresent | userPresent2

The background task is triggered when the user becomes present.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and 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 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  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 | userAway3

The background task is triggered when the user becomes absent.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and 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 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  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 | networkStateChange4

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

ControlChannelReset | controlChannelReset5

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, and 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 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  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 | internetAvailable6

The background task is triggered when the Internet becomes available.

SessionConnected | sessionConnected7

The background task is triggered when the session is connected.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and 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 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  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 | servicingComplete8

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

LockScreenApplicationAdded | lockScreenApplicationAdded9

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

LockScreenApplicationRemoved | lockScreenApplicationRemoved10

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

TimeZoneChange | timeZoneChange11

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 | onlineIdConnectedStateChange12

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

BackgroundWorkCostChange | backgroundWorkCostChange13

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

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and 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 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  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 | powerStateChange14

The background task is triggered when the power state changes. Power state changes include charging, discharging, plugged in, or a change in the number of batteries connected to the system.

Note  This value was introduced in Windows 10 Insider Preview.

Requirements (device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (operating system)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadata

Windows.winmd

See also

SystemTrigger.TriggerType

 

 

Show:
© 2015 Microsoft