Freigeben über


DeviceServicingTrigger Klasse

Definition

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.

Wichtig

Dieser Trigger kann nicht mit Einzelprozess-Hintergrundaufgaben verwendet werden.

public ref class DeviceServicingTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DeviceServicingTrigger final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DeviceServicingTrigger
[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
Implementiert

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:

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.

Gilt für:

Weitere Informationen