Windows Dev Center

BackgroundTaskBuilder.Register | register Method

Registriert einen Hintergrundtask beim System.

Syntax


var backgroundTaskRegistration = backgroundTaskBuilder.register();

Parameter

Methode besitzt keine Parameter.

Rückgabewert

Typ: BackgroundTaskRegistration

Eine Instanz eines BackgroundTaskRegistration-Objekts.

Hinweise

Die Aufgabe muss über einen Ereignistrigger und einen Einstiegspunkt für Aufgaben verfügen, damit die Register-Methode erfolgreich ist. Die Hintergrundaufgabe wird eingeplant, wenn das Triggerereignis auftritt und alle dazugehörigen Bedingungen erfüllt sind.

Validierung der Hintergrundaufgabenparameter

Windows 8:  Windows 8 überprüft nicht die Parameter, die für das BackgroundTaskBuilder-Objekt festgelegt werden, bis das System versucht, die Hintergrundaufgabe auszuführen. Wenn die Parameter nicht gültig sind, kann der Hintergrundtask nicht starten und ein Ereignisprotokolleintrag wird erstellt.

Windows 8.1:  Ab Windows 8.1 werden die zum Registrieren der Hintergrundtask verwendeten Parameter zum Zeitpunkt der Registrierung überprüft. Ein Fehler wird zurückgegeben, wenn die Hintergrundtaskregistrierung fehlschlägt. Dadurch kann die App bestimmen, ob der Hintergrundtask gültig ist.

Vorhandene Windows 8-Apps, die auf Windows 8.1 ausgeführt werden, unterliegen diesem neuen Systemverhalten, das zum Absturz der App führen kann, wenn eine fehlgeschlagene Hintergrundtaskregistrierung nicht behandelt werden kann. (Ein Ereignisprotokolleintrag wird auch weiterhin für die fehlgeschlagene Hintergrundtask-Registrierung erzeugt.) Folglich sollten Windows 8-Apps, die ungültige Hintergrundaufgaben registrieren, umgeschrieben werden, um Hintergrundaufgaben ordnungsgemäß zu registrieren und um die Registrierung fehlerhafter Hintergrundaufgaben zu behandeln.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadaten

Windows.winmd

Siehe auch

BackgroundTaskBuilder

 

 

Anzeigen:
© 2015 Microsoft