SystemTriggerType enumeration

Applies to Windows and Windows Phone

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.

Note  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

UserAway | userAway3

The background task is triggered when the user becomes absent.

Note  An app must be placed on the lock screen before it 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  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type. This trigger type does not support a OneShot mode. So the OneShot parameter must be false when using the SystemTrigger constructor.

InternetAvailable | internetAvailable6

The background task is triggered when the Internet becomes available.

SessionConnected | sessionConnected7

The background task is triggered when the session is connected.

Note  An app must be placed on the lock screen before it 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.

Note  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

CachedFileUpdated | cachedFileUpdated50

Supported on Windows Phone only. The background task is triggered when a cached file for which the app is a provider is updated.

Requirements

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:
© 2014 Microsoft. All rights reserved.