다음을 통해 공유


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 조건이 있는 백그라운드 작업이 트리거되고 사용자가 자리를 비면 사용자가 있을 때까지 작업이 실행되지 않습니다.

적용 대상

추가 정보