Freigeben über


IBackgroundTaskInstance4 Schnittstelle

Definition

Bietet Zugriff auf eine Hintergrundaufgabe instance einschließlich Informationen über den Benutzer.

public interface class IBackgroundTaskInstance4 : IBackgroundTaskInstance
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
struct IBackgroundTaskInstance4 : IBackgroundTaskInstance
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
public interface IBackgroundTaskInstance4 : IBackgroundTaskInstance
Public Interface IBackgroundTaskInstance4
Implements IBackgroundTaskInstance
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Eigenschaften

InstanceId

Ruft die instance-ID der hintergrundaufgaben-instance ab.

(Geerbt von IBackgroundTaskInstance)
Progress

Ruft den Status status für eine Hintergrundaufgabe instance ab oder legt diese fest.

(Geerbt von IBackgroundTaskInstance)
SuspendedCount

Ruft ab, wie oft die Ressourcenverwaltungsrichtlinie dazu geführt hat, dass die Hintergrundaufgabe angehalten wurde.

(Geerbt von IBackgroundTaskInstance)
Task

Ruft Zugriff auf die registrierte Hintergrundaufgabe für diese Hintergrundaufgabe instance ab.

(Geerbt von IBackgroundTaskInstance)
TriggerDetails

Ruft zusätzliche Informationen ab, die einer Hintergrundaufgabe instance zugeordnet sind.

(Geerbt von IBackgroundTaskInstance)
User

Ruft den Benutzerkontext für die Hintergrundaufgabe ab. AppServiceConnection.User wird von der aufrufenden App verwendet, um den Benutzerkontext zu übergeben. Der App-Dienst kann diesen Benutzerkontext mit dieser Eigenschaft abrufen.

Methoden

GetDeferral()

Informiert das System darüber, dass die Hintergrundaufgabe nach dem Zurückgeben der IBackgroundTask.Run-Methode möglicherweise weiterhin Arbeiten ausführt.

(Geerbt von IBackgroundTaskInstance)

Ereignisse

Canceled

Fügt einen Abbruchereignishandler an die Hintergrundaufgabe instance an.

Bei Windows Phone 8.x-App können Hintergrundaufgaben ohne Warnung und ohne Auslösen des OnCanceled-Ereignisses beendet werden, wenn auf dem Gerät wenig Arbeitsspeicher verfügbar ist. Dadurch soll die Benutzerfreundlichkeit der App im Vordergrund sichergestellt werden. Entwerfen Sie die Hintergrundaufgabe so, dass dieses Szenario behandelt werden kann. Beachten Sie, dass dies nur für Windows Phone gilt.

(Geerbt von IBackgroundTaskInstance)

Gilt für:

Weitere Informationen