다음을 통해 공유


BackgroundExecutionManager.RequestAccessAsync 메서드

정의

오버로드

RequestAccessAsync()

앱이 백그라운드 작업을 실행할 수 있도록 허용하도록 요청합니다.

RequestAccessAsync(String)

앱이 백그라운드 작업을 실행할 수 있도록 비동기적으로 요청합니다.

RequestAccessAsync()

앱이 백그라운드 작업을 실행할 수 있도록 허용하도록 요청합니다.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync();
/// [Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
[Windows.Foundation.Metadata.Overload("RequestAccessAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync();
function requestAccessAsync()
Public Shared Function RequestAccessAsync () As IAsyncOperation(Of BackgroundAccessStatus)

반환

작업이 완료되면 결과를 지정하는 BackgroundAccessStatus 열거형의 멤버를 반환합니다.

특성

설명

버전동작
Windows 8/Windows 8.1잠금 화면에 앱을 추가하도록 요청하는 대화 상자가 사용자에게 표시됩니다. 백그라운드 작업을 등록하기 전에 호출해야 합니다.
Windows Phone 8.1사용자에게 메시지를 표시하지 않지만 백그라운드 작업을 등록하기 전에 를 호출해야 합니다.
Windows 10사용자에게 메시지를 표시하지 않지만 백그라운드 작업을 등록하기 전에 를 호출해야 합니다. Windows 10 백그라운드 작업을 사용하기 위해 잠금 화면에 앱을 추가할 필요는 없지만 이 메서드를 호출하여 백그라운드 액세스를 요청해야 합니다.

Windows 10 시작하여 더 이상 UI 스레드에서 이 메서드를 호출할 필요가 없습니다.

추가 정보

적용 대상

RequestAccessAsync(String)

앱이 백그라운드 작업을 실행할 수 있도록 비동기적으로 요청합니다.

public:
 static IAsyncOperation<BackgroundAccessStatus> ^ RequestAccessAsync(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("RequestAccessForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BackgroundAccessStatus> RequestAccessAsync(string applicationId);
function requestAccessAsync(applicationId)
Public Shared Function RequestAccessAsync (applicationId As String) As IAsyncOperation(Of BackgroundAccessStatus)

매개 변수

applicationId
String

Platform::String

winrt::hstring

백그라운드 작업을 실행할 수 있는 앱의 PRAID(패키지 상대 애플리케이션 식별자)입니다. 지정된 앱은 호출 앱과 동일한 패키지에 있어야 합니다. PRAID에 대한 자세한 내용은 Application 요소의 Id 특성을 참조하세요.

기본 애플리케이션과 별도로 out-of-process COM 서버에서 백그라운드 작업을 호스팅하는 경우 자체 패키지 매니페스트에서 확장을 정의하는 애플리케이션의 PRAID에 대한 applicationId 인수로 전달합니다windows.backgroundTask.

반환

비동기 요청 작업입니다. 성공적으로 완료되면 결과를 지정하는 BackgroundAccessStatus 열거형의 멤버를 포함합니다.

특성

설명

버전 동작
Windows 8/Windows 8.1 잠금 화면에 앱을 추가하도록 요청하는 대화 상자가 사용자에게 표시됩니다. 백그라운드 작업을 등록하기 전에 호출해야 합니다.
Windows Phone 8.1 사용자에게 메시지를 표시하지 않지만 백그라운드 작업을 등록하기 전에 를 호출해야 합니다.
Windows 10 사용자에게 메시지를 표시하지 않지만 백그라운드 작업을 등록하기 전에 를 호출해야 합니다. Windows 10 백그라운드 작업을 사용하기 위해 잠금 화면에 앱을 추가할 필요는 없지만 백그라운드 액세스를 요청하려면 이 메서드 또는 RequestAccessAsync를 호출해야 합니다.

Windows 10 시작하여 더 이상 UI 스레드에서 이 메서드를 호출할 필요가 없습니다.

추가 정보

적용 대상