BackgroundExecutionManager.RequestAccessAsync 메서드

정의

네임스페이스:

Windows.ApplicationModel.Background

오버로드

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)

반환

IAsyncOperation<BackgroundAccessStatus>

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

특성

OverloadAttribute RemoteAsyncAttribute

설명

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

팁

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

추가 정보

• RequestAccessAsync(String)

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.

반환

IAsyncOperation<BackgroundAccessStatus>

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

특성

OverloadAttribute RemoteAsyncAttribute

설명

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

팁

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

추가 정보

• RequestAccessAsync