AppInstallManager Klasse

Definition

Namespace:: Windows.ApplicationModel.Store.Preview.InstallControl

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

Stellt Mitglieder zum programmgesteuerten Installieren von Apps bereit, einschließlich der Möglichkeit, eine App-Installation zu starten und eine Liste der derzeit ausgeführten App-Installationen abzurufen.

public ref class AppInstallManager 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)]
class AppInstallManager final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class AppInstallManager 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)]
public sealed class AppInstallManager

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

function AppInstallManager()

Public NotInheritable Class AppInstallManager

Vererbung: Object Platform::Object IInspectable AppInstallManager

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Anforderungen	Beschreibung
Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	runFullTrust

Hinweise

Von Bedeutung

Der Zugriff auf diese API ist durch eine private Funktion geschützt, die auf Apps beschränkt ist, die von Microsoft entwickelt werden.

Hinweis

Vermeiden Sie das Aufrufen von AppInstallManager.StartProductInstallAsync oder AppInstallManager.StartProductInstallForUserAsync während der Windows Out of Box Experience (OOBE).

Installationsanforderungen, die vor Abschluss der Windows-Willkommensseite vorgenommen wurden, verhalten sich möglicherweise nicht wie erwartet, da storebezogene Dienste möglicherweise noch nicht vollständig initialisiert werden.

Rufen Sie diese Methoden nach der ersten Benutzeranmeldung auf, um optimale Ergebnisse zu erzielen.

Versionsverlauf

Windows Version	SDK-Version	Mehrwert
1511	10586	Cancel(String,String)
1511	10586	GetIsAppAllowedToInstallAsync(String,String,String,String)
1511	10586	Pause(Zeichenfolge;Zeichenfolge)
1511	10586	Restart(String,String)
1511	10586	SearchForAllUpdatesAsync(String)
1511	10586	SearchForUpdatesAsync(String,String,String,String)
1511	10586	StartAppInstallAsync(String,String,Boolean,Boolean,String,String,String)
1511	10586	UpdateAppByPackageFamilyNameAsync(String,String)
1607	14393	GetIsAppAllowedToInstallForUserAsync
1607	14393	GetIsApplicableForUserAsync
1607	14393	MoveToFrontOfDownloadQueue
1607	14393	SearchForAllUpdatesForUserAsync(User,String)
1607	14393	SearchForUpdatesForUserAsync(User,String,String,String,String)
1607	14393	StartProductInstallAsync(String,String,String,String,Boolean,Boolean,String,PackageVolume)
1607	14393	StartProductInstallForUserAsync(User,String,String,String,String,Boolean,Boolean,String,String,PackageVolume)
1607	14393	UpdateAppByPackageFamilyNameForUserAsync
1703	15063	AppInstallItemsWithGroupSupport
1703	15063	GetFreeDeviceEntitlementAsync
1703	15063	GetFreeUserEntitlementAsync
1703	15063	GetFreeUserEntitlementForUserAsync
1803	17134	GetIsPackageIdentityAllowedToInstallAsync
1803	17134	GetIsPackageIdentityAllowedToInstallForUserAsync
1803	17134	SearchForAllUpdatesAsync(String,String,AppUpdateOptions)
1803	17134	SearchForAllUpdatesForUserAsync(User,String,String,AppUpdateOptions)
1803	17134	SearchForUpdatesAsync(String,String,String,String,String,AppUpdateOptions)
1803	17134	SearchForUpdatesForUserAsync(User,String,String,String,String,String,String,AppUpdateOptions)
1803	17134	StartProductInstallAsync(String,String,String,String,AppInstallOptions)
1803	17134	StartProductInstallForUserAsync(User,String,String,String,String,String,AppInstallOptions)
1809	17763	CanInstallForAllUsers

Konstruktoren

Name	Beschreibung
AppInstallManager()	Erstellt und initialisiert eine neue Instanz der AppInstallManager-Klasse .

Eigenschaften

Name	Beschreibung
AcquisitionIdentity	Dient zum Abrufen oder Festlegen der Benutzeridentität, die der App-Installationen zugeordnet ist.
AppInstallItems	Ruft Informationen zu allen Apps ab, die sich derzeit in der Installationswarteschlange befinden.
AppInstallItemsWithGroupSupport	Ruft Informationen zu allen Apps ab, die Teil eines einzelnen App-Bündels sind, das sich derzeit in der Installationswarteschlange befindet.
AutoUpdateSetting	Dient zum Abrufen oder Festlegen der Einstellung für die automatische Aktualisierung für Apps auf dem aktuellen Computer oder Gerät.
CanInstallForAllUsers	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die aufrufende App über erhöhte Administratorrechte verfügt, um sicherzustellen, dass die Installation einer App für alle Benutzer erfolgreich ist.

Methoden

Name	Beschreibung
Cancel(String, String)	Bricht die Installation der angegebenen App ab, mit der Option zum Generieren von Telemetriedaten.
Cancel(String)	Bricht die Installation der angegebenen App ab.
GetFreeDeviceEntitlementAsync(String, String, String)	Gewährt allen Benutzern auf dem aktuellen Gerät eine kostenlose Berechtigung für die angegebene App.
GetFreeUserEntitlementAsync(String, String, String)	Gewährt dem aktuellen Benutzer eine kostenlose Berechtigung für die angegebene App.
GetFreeUserEntitlementForUserAsync(User, String, String, String)	Gewährt dem angegebenen Benutzer eine kostenlose Berechtigung für die angegebene App.
GetIsAppAllowedToInstallAsync(String, String, String, String)	Bestimmt, ob die angegebene App über die Berechtigung zum Installieren auf dem aktuellen Computer oder Gerät verfügt, mit der Option zum Generieren von Telemetriedaten.
GetIsAppAllowedToInstallAsync(String)	Bestimmt, ob die angegebene App über die Berechtigung zum Installieren auf dem aktuellen Computer oder Gerät verfügt.
GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String)	Bestimmt, ob die angegebene App über die Berechtigung zum Installieren auf dem aktuellen Computer oder Gerät für den angegebenen Benutzer verfügt, mit der Option zum Generieren von Telemetriedaten.
GetIsApplicableAsync(String, String)	Bestimmt, ob die angegebene App auf dem aktuellen Computer oder Gerät installiert werden kann.
GetIsApplicableForUserAsync(User, String, String)	Bestimmt, ob die angegebene App auf dem aktuellen Computer oder Gerät für den angegebenen Benutzer installiert werden kann.
GetIsPackageIdentityAllowedToInstallAsync(String, String, String)	Gibt einen Wert zurück, der angibt, ob das Paket mit den angegebenen Identitätsinformationen auf dem aktuellen Gerät installiert werden darf.
GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String)	Gibt einen Wert zurück, der angibt, ob das Paket mit den angegebenen Identitätsinformationen auf dem aktuellen Gerät für den angegebenen Benutzer installiert werden darf.
IsStoreBlockedByPolicyAsync(String, String)	Bestimmt, ob die angegebene App durch Eine Richtlinie auf dem aktuellen Computer oder Gerät blockiert wird.
MoveToFrontOfDownloadQueue(String, String)	Verschiebt die angegebene App an den Anfang der Downloadwarteschlange.
Pause(String, String)	Hält die Installation der angegebenen App an, mit der Option zum Generieren von Telemetriedaten.
Pause(String)	Hält die Installation der angegebenen App an.
Restart(String, String)	Startet die Installation der angegebenen App neu, mit der Option zum Generieren von Telemetriedaten.
Restart(String)	Startet die Installation der angegebenen App neu.
SearchForAllUpdatesAsync()	Sucht nach allen verfügbaren Updates für Apps, die auf dem aktuellen Computer oder Gerät installiert sind.
SearchForAllUpdatesAsync(String, String, AppUpdateOptions)	Sucht nach allen verfügbaren Updates für Apps, die auf dem aktuellen Computer oder Gerät installiert sind, mit der Möglichkeit, erzwungene App-Neustarts und die Option zum Generieren von Telemetriedaten zuzulassen.
SearchForAllUpdatesAsync(String)	Sucht nach allen verfügbaren Updates für Apps, die auf dem aktuellen Computer oder Gerät installiert sind, mit der Option zum Generieren von Telemetriedaten.
SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions)	Sucht nach allen verfügbaren Updates für Apps, die auf dem aktuellen Computer oder Gerät für den angegebenen Benutzer installiert sind, mit der Möglichkeit, erzwungene App-Neustarts und die Option zum Generieren von Telemetriedaten zuzulassen.
SearchForAllUpdatesForUserAsync(User, String)	Sucht nach allen verfügbaren Updates für Apps, die auf dem aktuellen Computer oder Gerät für den angegebenen Benutzer installiert sind, mit der Option zum Generieren von Telemetriedaten.
SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions)	Sucht nach Updates für die angegebene App, mit der Möglichkeit, einen erzwungenen App-Neustart und die Option zum Generieren von Telemetriedaten zuzulassen.
SearchForUpdatesAsync(String, String, String, String)	Sucht nach Updates für die angegebene App mit der Option zum Generieren von Telemetriedaten.
SearchForUpdatesAsync(String, String)	Sucht nach Updates für die angegebene App.
SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions)	Sucht nach Updates für die angegebene App und den angegebenen Benutzer, mit der Möglichkeit, einen erzwungenen App-Neustart und die Option zum Generieren von Telemetriedaten zuzulassen.
SearchForUpdatesForUserAsync(User, String, String, String, String)	Sucht nach Updates für die angegebene App und den angegebenen Benutzer, mit der Option zum Generieren von Telemetriedaten.
StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String)	Hinweis Bitte beachten Sie, dass die `AppInstallManager.StartAppInstallAsync` Methode offiziell eingestellt wurde. Weitere Informationen zu alternativen APIs für Ihre Anforderungen finden Sie in der AppInstallManager-Dokumentation . Startet die Installation der angegebenen App mit der Option zum Generieren von Telemetriedaten.
StartAppInstallAsync(String, String, Boolean, Boolean)	Hinweis Bitte beachten Sie, dass die `AppInstallManager.StartAppInstallAsync` Methode offiziell eingestellt wurde. Weitere Informationen zu alternativen APIs für Ihre Anforderungen finden Sie in der AppInstallManager-Dokumentation . Startet die Installation der angegebenen App.
StartProductInstallAsync(String, String, String, String, AppInstallOptions)	Startet die Installation des angegebenen App- oder App-Bündels, mit der Möglichkeit, zusätzliche Installationsoptionen anzugeben, z. B. ob ein erzwungener App-Neustart zulässig ist. Hinweis Vermeiden Sie das Aufrufen von `AppInstallManager.StartProductInstallAsync` oder `AppInstallManager.StartProductInstallForUserAsync` während der Windows Out of Box Experience (OOBE). Installationsanforderungen, die vor Abschluss der Windows-Willkommensseite vorgenommen wurden, verhalten sich möglicherweise nicht wie erwartet, da storebezogene Dienste möglicherweise noch nicht vollständig initialisiert werden. Rufen Sie diese Methoden nach der ersten Benutzeranmeldung auf, um optimale Ergebnisse zu erzielen.
StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume)	Startet die Installation des angegebenen App- oder App-Bündels.
StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions)	Startet die Installation des angegebenen App- oder App-Bündels für den angegebenen Benutzer, mit der Möglichkeit, zusätzliche Installationsoptionen anzugeben, z. B. ob ein erzwungener App-Neustart zugelassen werden soll. Hinweis Vermeiden Sie das Aufrufen von `AppInstallManager.StartProductInstallAsync` oder `AppInstallManager.StartProductInstallForUserAsync` während der Windows Out of Box Experience (OOBE). Installationsanforderungen, die vor Abschluss der Windows-Willkommensseite vorgenommen wurden, verhalten sich möglicherweise nicht wie erwartet, da storebezogene Dienste möglicherweise noch nicht vollständig initialisiert werden. Rufen Sie diese Methoden nach der ersten Benutzeranmeldung auf, um optimale Ergebnisse zu erzielen.
StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume)	Startet die Installation des angegebenen App- oder App-Bündels für den angegebenen Benutzer.
UpdateAppByPackageFamilyNameAsync(String, String)	Startet das Update einer App, die durch den Paketfamiliennamen angegeben ist, mit der Option zum Generieren von Telemetriedaten.
UpdateAppByPackageFamilyNameAsync(String)	Startet das Update einer App, die durch den Paketfamiliennamen angegeben ist.
UpdateAppByPackageFamilyNameForUserAsync(User, String, String)	Startet die Aktualisierung einer App für einen bestimmten Benutzer, der durch den Paketfamiliennamen angegeben ist, mit der Option zum Generieren von Telemetriedaten.

Ereignisse

Name	Beschreibung
ItemCompleted	Tritt auf, wenn die Installation einer App abgeschlossen ist.
ItemStatusChanged	Tritt auf, wenn sich der Status einer App in der Installationswarteschlange geändert hat.

Gilt für:

Feedback

War diese Seite hilfreich?