DeviceServicingTrigger Klasse

Definition

Namespace:

Windows.ApplicationModel.Background

Stellt ein Ereignis dar, das von einer Anwendung ausgelöst werden kann, um ein Update mit langer Laufzeit (Firmware oder Einstellungen) eines Geräts zu initiieren.

Windows 8.1 ermöglicht Ihnen die Entwicklung einer UWP-App für Ihre Peripheriegeräte, die über USB, HID und Bluetooth kommunizieren. Beispielsweise muss ein Benutzer Inhalte auf einem PC mit oder vom Gerät synchronisieren oder ein Update mit langer Ausführungszeit für das Gerät selbst durchführen, z. B. Einstellungen oder Firmwareupdates. Windows 8.1 bietet zwei Hintergrundaufgaben und entsprechende APIs, mit denen Ihr Gerät im Hintergrund synchronisiert und aktualisiert werden kann: DeviceServicingTrigger und DeviceUseTrigger. Dieses Thema enthält API-Referenzinformationen für DeviceServicingTrigger. Informationen zur Verwendung dieses Triggers im Kontext einer Geräte-App finden Sie unter Gerätesynchronisierung und -update für UWP-Geräte-Apps.

Mit der Hintergrundaufgabe DeviceServicingTrigger kann Ihre UWP-App, die mit Ihrem Peripheriegerät interagiert, Geräteupdates mit langer Ausführung ausführen, während Ihre App angehalten wird, z. B. Einstellungsübertragungen oder Firmwareupdates. Das Aktualisieren Ihres Geräts im Hintergrund erfordert jedes Mal die Benutzergenehmigung, wenn die Hintergrundaufgabe verwendet wird. Im Gegensatz zur DeviceUseTrigger-Hintergrundaufgabe ermöglicht die DeviceServicingTrigger-Hintergrundaufgabe den Neustart und die Trennung des Geräts und ermöglicht maximal 30 Minuten Hintergrundaktivität.

• Weitere Details zu den Richtlinienanforderungen der DeviceServicingTrigger-Hintergrundaufgabe finden Sie im Abschnitt dieser Seite.
• Informationen zur Verwendung von DeviceServicingTrigger finden Sie unter Gerätesynchronisierung und -update für UWP-Geräte-Apps.
• Informationen zur Verwendung von DeviceUseTrigger finden Sie unter Zugreifen auf Sensoren und Geräte über eine Hintergrundaufgabe.

Wichtig

Dieser Trigger kann nicht mit Einzelprozess-Hintergrundaufgaben verwendet werden.

public ref class DeviceServicingTrigger sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceServicingTrigger final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceServicingTrigger

function DeviceServicingTrigger()

Public NotInheritable Class DeviceServicingTrigger

Vererbung

Object Platform::Object IInspectable DeviceServicingTrigger

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IBackgroundTrigger

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Bestimmte Richtlinien werden von Windows erzwungen, um die Zustimmung des Benutzers beim Aktualisieren seiner Peripheriegeräte sicherzustellen. Weitere Richtlinien werden erzwungen, um für Benutzer die Akkulaufzeit zu verlängern, wenn Peripheriegeräte synchronisiert und aktualisiert werden. Die Hintergrundaufgabe DeviceServicingTrigger unterliegt den folgenden Richtlinien:

• Die DeviceServicingTrigger-Hintergrundaufgabe erfordert jedes Mal, wenn sie ausgelöst wird, die Zustimmung des Benutzers.
• Ihr Gerät muss mit dem PC verbunden oder gekoppelt sein und beim Anfordern von DeviceServicingTrigger verfügbar sein.
• Ihre App ist maximal 30 Minuten (Wanduhr) der Hintergrundaktivität für Geräteupdates mit DeviceServicingTrigger zulässig.
• Ihre App darf keine DeviceServicingTrigger-Hintergrundaufgabe anfordern, während sich Ihre App nicht im Vordergrund befindet.
• Ihre App kann nur jeweils eine DeviceServicingTrigger-Instanz ausführen. Beim Versuch, ein zweites DeviceServicingTrigger zu erstellen, wird eine Ausnahme ausgelöst.
• Der Akku des PCs muss mehr als 33 % verbleibende Kapazität aufweisen, oder der PC muss mit Strom versorgt werden.
• DeviceServicingTrigger-Hintergrundaufgaben können von Windows abgebrochen werden, wenn diese Richtlinienanforderungen nicht mehr erfüllt werden, einschließlich einer maximalen Menge an Hintergrundzeit für die Wanduhr.

Hinweis

UWP-App, die die DeviceServicingTrigger-Hintergrundaufgabe verwenden soll, muss auch eine privilegierte App für das Gerät sein. App-Berechtigungen werden vom Gerätehersteller in den Gerätemetadaten für ein Peripheriegerät angegeben. Wenn eine UWP-App versucht, die DeviceServicingTrigger-Hintergrundaufgabe auszulösen , überprüft Windows, ob die aufrufende App die privilegierte App für das Gerät ist, das sie aktualisieren möchte. Wenn die App für das Gerät nicht privilegiert ist, lässt Windows das Starten der Hintergrundaufgabe nicht zu.

Ausführliche Informationen zu App-Berechtigungen und den von Windows für die DeviceServicingTrigger-Hintergrundaufgabe erzwungenen Richtlinienprüfungen finden Sie unter Gerätesynchronisierung und -update für UWP-Geräte-Apps.

Konstruktoren

DeviceServicingTrigger()

Konstruktor für DeviceServicingTrigger. Nimmt keine Parameter an.

Methoden

RequestAsync(String, TimeSpan)

Löst die Hintergrundaufgabe (Einstellungen oder Firmwareupdate) aus und gibt ein DeviceTriggerResult zurück, das den Erfolg oder Fehler der Triggeranforderung angibt. Benötigt die DeviceInformation.ID Zeichenfolge und eine optionale geschätzte Zeit für die Ausführung der Hintergrundaufgabe. Wenn Ihre App keine geeignete Zeitschätzung ermitteln kann, geben Sie null als geschätzte Zeit an.

RequestAsync(String, TimeSpan, String)

Löst die Hintergrundaufgabe (Einstellungen oder Firmwareupdate) aus und gibt ein DeviceTriggerResult zurück, das den Erfolg oder Fehler der Triggeranforderung angibt. Übernimmt die DeviceInformation.ID Zeichenfolge, eine optionale geschätzte Ausführungszeit der Hintergrundaufgabe und eine optionale App-spezifische Zeichenfolge, die an die Hintergrundaufgabe übergeben wird, um den auszuführenden Gerätevorgang zu identifizieren. Wenn Ihre App keine geeignete Zeitschätzung ermitteln kann, geben Sie null als geschätzte Zeit an.

Weitere Informationen

• IBackgroundTrigger