SystemConditionType enumeration

Applies to Windows and Windows Phone

Specifies a system condition that must be in effect for a background task to run. If a background task with a system condition is triggered, the task will not run until the condition is met.

Syntax


var value = Windows.ApplicationModel.Background.SystemConditionType.invalid;

Attributes

[Version(0x06020000)]

Members

The SystemConditionType enumeration has these members.

MemberValueDescription
Invalid | invalid0

Not a valid condition type.

UserPresent | userPresent1

Specifies that the background task can only run when the user is present. If a background task with the UserPresent condition is triggered, and the user is away, the task will not run until the user is present.

UserNotPresent | userNotPresent2

Specifies that background task can only run when the user is not present. If a background task with the UserNotPresent condition is triggered, and the user is present, the task will not run until the user becomes inactive.

InternetAvailable | internetAvailable3

Specifies that the background task can only run when the Internet is available. If a background task with the InternetAvailable condition is triggered, and the Internet is not available, the task will not run until the Internet is available again.

InternetNotAvailable | internetNotAvailable4

Specifies that the background task can only run when the Internet is not available. If a background task with the InternetNotAvailable condition is triggered, and the Internet is available, the task will not run until the Internet is unavailable.

SessionConnected | sessionConnected5

Specifies that the background task can only run when the user's session is connected. If a background task with the SessionConnected condition is triggered, and the user session is not logged in, the task will run when the user logs in.

SessionDisconnected | sessionDisconnected6

Specifies that the background task can only run when the user's session is disconnected. If a background task with the SessionDisconnected condition is triggered, and the user is logged in, the task will run when the user logs out.

FreeNetworkAvailable | freeNetworkAvailable7

Specifies that the background task can only run when a free (non-metered) network connection is available.

BackgroundWorkCostNotHigh | backgroundWorkCostNotHigh8

Specifies that the background task can only run when the cost to do background work is low.

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

SystemCondition.ConditionType

 

 

Show:
© 2014 Microsoft. All rights reserved.