IBackgroundTaskInstance4 Schnittstelle

Referenz

Definition

Namespace:: Windows.ApplicationModel.Background

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute GuidAttribute

Implementiert: IBackgroundTaskInstance

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

IBackgroundTaskInstance

Share via