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

注釈

Version	動作
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 属性を参照してください。

プロセス外の COM サーバーでバックグラウンド タスクをホストしている場合は、メイン アプリケーションとは別に、独自のパッケージ マニフェストで拡張機能を定義windows.backgroundTaskするアプリケーションの PRAID の引数applicationIdとして を渡します。

戻り値

IAsyncOperation<BackgroundAccessStatus>

非同期要求操作。 正常に完了すると、 には、結果を指定する BackgroundAccessStatus 列挙体のメンバーが含まれます。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

Version	動作
Windows 8/Windows 8.1	アプリをロック画面に追加するよう要求するダイアログ ボックスをユーザーに求めます。 バックグラウンド タスクを登録する前に を呼び出す必要があります。
Windows Phone 8.1	ユーザーにプロンプトを表示しませんが、バックグラウンド タスクを登録する前に を呼び出す必要があります。
Windows 10	ユーザーにプロンプトを表示しませんが、バックグラウンド タスクを登録する前に を呼び出す必要があります。 Windows 10でバックグラウンド タスクを使用するためにアプリをロック画面に追加する必要はありませんが、バックグラウンド アクセスを要求するには、このメソッド (RequestAccessAsync) を呼び出す必要があります。

ヒント

Windows 10以降、UI スレッドからこのメソッドを呼び出す必要はなくなりました。

こちらもご覧ください

• RequestAccessAsync