SystemConditionType 열거형

정의

백그라운드 작업을 실행하기 위해 적용되어야 하는 시스템 조건을 지정합니다. 시스템 조건이 있는 백그라운드 작업이 트리거되면 조건이 충족될 때까지 작업이 실행되지 않습니다.

public enum class SystemConditionType
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class SystemConditionType
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum SystemConditionType
var value = Windows.ApplicationModel.Background.SystemConditionType.invalid
Public Enum SystemConditionType
상속
SystemConditionType
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

필드

BackgroundWorkCostNotHigh 8

백그라운드 작업을 수행하는 데 드는 비용이 낮은 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다.

FreeNetworkAvailable 7

무료(요금제가 아닌) 네트워크 연결을 사용할 수 있는 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다.

InternetAvailable 3

인터넷을 사용할 수 있는 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다. InternetAvailable 조건이 있는 백그라운드 작업이 트리거되고 인터넷을 사용할 수 없는 경우 인터넷을 다시 사용할 수 있을 때까지 작업이 실행되지 않습니다. 네트워크가 가동되어야 백그라운드 작업이 실행되기 때문에 이 조건을 적용하면 전원이 절약됩니다. 이 조건은 실시간 정품 인증을 제공하지 않습니다.

중요

백그라운드 작업이 실행되는 동안 네트워크가 유지되도록 백그라운드 작업에서 IsNetworkRequested 를 설정합니다. 이렇게 하면 디바이스가 연결된 대기 모드로 전환된 경우에도 작업이 실행되는 동안 네트워크를 유지하도록 백그라운드 작업 인프라에 지시하므로 핵심 네트워킹 API(HttpClient, StreamSocket, DatagramSocket 등)를 호출할 수 있습니다. 백그라운드 작업이 IsNetworkRequested를 설정하지 않으면 연결된 대기 모드(예: 휴대폰 화면이 꺼져 있는 경우)에서 백그라운드 작업이 네트워크에 액세스할 수 없습니다.

InternetNotAvailable 4

인터넷을 사용할 수 없는 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다. InternetNotAvailable 조건이 있는 백그라운드 작업이 트리거되고 인터넷을 사용할 수 있는 경우 인터넷을 사용할 수 없을 때까지 작업이 실행되지 않습니다.

Invalid 0

유효한 조건 유형이 아닙니다.

SessionConnected 5

사용자의 세션이 연결된 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다. SessionConnected 조건이 있는 백그라운드 작업이 트리거되고 사용자 세션이 로그인되지 않은 경우 사용자가 로그인할 때 작업이 실행됩니다.

SessionDisconnected 6

사용자의 세션 연결이 끊어진 경우에만 백그라운드 작업을 실행할 수 있도록 지정합니다. SessionDisconnected 조건이 있는 백그라운드 작업이 트리거되고 사용자가 로그인되면 사용자가 원격 데스크톱 세션의 연결을 끊거나 빠른 사용자 전환을> 수행할 때 작업이 실행됩니다. 참고]

SessionDisconnected 는 주로 원격 데스크톱 및 빠른 사용자 전환의 컨텍스트에서 사용됩니다. 사용자가 컴퓨터에서 로그오프했다는 알림으로 사용되지는 않습니다.

UserNotPresent 2

사용자가 없을 때만 백그라운드 작업을 실행할 수 있도록 지정합니다. UserNotPresent 조건이 있는 백그라운드 작업이 트리거되고 사용자가 있는 경우 사용자가 비활성 상태가 될 때까지 작업이 실행되지 않습니다.

UserPresent 1

사용자가 있을 때만 백그라운드 작업을 실행할 수 있도록 지정합니다. UserPresent 조건이 있는 백그라운드 작업이 트리거되고 사용자가 자리를 비면 사용자가 있을 때까지 작업이 실행되지 않습니다.

적용 대상

추가 정보