IBackgroundTaskInstance2 インターフェイス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Background

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

バックグラウンドタスクインスタンスへのアクセスを提供します。 IBackgroundTaskInstance インターフェイスから継承し、GetThrottleCount メソッドを追加します。

public interface class IBackgroundTaskInstance2 : IBackgroundTaskInstance

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
struct IBackgroundTaskInstance2 : IBackgroundTaskInstance

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1333592438, 3190, 20404, 137, 109, 93, 225, 134, 65, 34, 246)]
public interface IBackgroundTaskInstance2 : IBackgroundTaskInstance

Public Interface IBackgroundTaskInstance2
Implements IBackgroundTaskInstance

属性: ContractVersionAttribute GuidAttribute

実装: IBackgroundTaskInstance

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

プロパティ

InstanceId	バックグラウンドタスクインスタンスのインスタンス ID を取得します。 (継承元 IBackgroundTaskInstance)
Progress	バックグラウンドタスクインスタンスの進行状況を取得または設定します。 (継承元 IBackgroundTaskInstance)
SuspendedCount	リソース管理ポリシーによってバックグラウンドタスクが中断された回数を取得します。 (継承元 IBackgroundTaskInstance)
Task	このバックグラウンドタスクインスタンスの登録済みバックグラウンドタスクへのアクセス権を取得します。 (継承元 IBackgroundTaskInstance)
TriggerDetails	バックグラウンドタスクインスタンスに関連付けられている追加情報を取得します。 (継承元 IBackgroundTaskInstance)

メソッド

GetDeferral()	IBackgroundTask.Run メソッドが戻った後もバックグラウンドタスクが引き続き作業を実行する可能性があることをシステムに通知します。 (継承元 IBackgroundTaskInstance)
GetThrottleCount(BackgroundTaskThrottleCounter)	リソースの使用が多すぎるため、バックグラウンドタスクが中断された回数を取得します。

イベント

Canceled

キャンセルイベントハンドラーをバックグラウンドタスクインスタンスにアタッチします。

Windows Phone 8.x アプリの場合、デバイスがメモリ不足になった場合、バックグラウンドタスクは警告なしで、OnCanceled イベントを発生させることなく終了する可能性があります。こうすることで、フォアグラウンドのアプリのユーザーエクスペリエンスが保証されます。バックグラウンドタスクは、このシナリオを処理できるように設計する必要があります。これはWindows Phoneにのみ適用されることに注意してください。

(継承元 IBackgroundTaskInstance)

適用対象

こちらもご覧ください

IBackgroundTaskInstance