AppInstallManager Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit aux membres la possibilité d’installer des applications par programmation, notamment la possibilité de démarrer une installation d’application et d’obtenir la liste des installations d’application en cours.
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 AppInstallManagerfunction AppInstallManager()Public NotInheritable Class AppInstallManager- Héritage
- Attributs
Configuration requise pour Windows
| Configuration requise | Description |
|---|---|
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
| Fonctionnalités de l’application |
runFullTrust
|
Remarques
Important
L’accès à cette API est protégé par une fonctionnalité privée qui est limitée aux applications développées par Microsoft.
Note
Évitez d’appeler AppInstallManager.StartProductInstallAsync ou AppInstallManager.StartProductInstallForUserAsync pendant l’expérience OOBE (Out of Box Experience) Windows.
Les demandes d’installation effectuées avant la fin de l’opération OOBE peuvent ne pas se comporter comme prévu, car les services associés au Windows Store peuvent ne pas encore être entièrement initialisés.
Pour obtenir de meilleurs résultats, appelez ces méthodes après la première connexion utilisateur.
Historique des versions
| version de Windows | Version du Kit de développement logiciel (SDK | Valeur ajoutée |
|---|---|---|
| 1511 | 10586 | Cancel(String,String) |
| 1511 | 10586 | GetIsAppAllowedToInstallAsync(String,String,String,String,String) |
| 1511 | 10586 | Pause(String,String) |
| 1511 | 10586 | Restart(String,String) |
| 1511 | 10586 | SearchForAllUpdatesAsync(String) |
| 1511 | 10586 | SearchForUpdatesAsync(String,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,String) |
| 1607 | 14393 | StartProductInstallAsync(String,String,String,String,String,Boolean,String,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,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesForUserAsync(User,String,String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | StartProductInstallAsync(String,String,String,String,String,AppInstallOptions) |
| 1803 | 17134 | StartProductInstallForUserAsync(User,String,String,String,String,String,AppInstallOptions) |
| 1809 | 17763 | CanInstallForAllUsers |
Constructeurs
| Nom | Description |
|---|---|
| AppInstallManager() |
Crée et initialise une nouvelle instance de la classe AppInstallManager. |
Propriétés
| Nom | Description |
|---|---|
| AcquisitionIdentity |
Obtient ou définit l’identité utilisateur associée à l’installation de l’application. |
| AppInstallItems |
Récupère des informations sur toutes les applications actuellement dans la file d’attente d’installation. |
| AppInstallItemsWithGroupSupport |
Récupère des informations sur toutes les applications qui font partie d’un groupe d’applications unique qui se trouve actuellement dans la file d’attente d’installation. |
| AutoUpdateSetting |
Obtient ou définit le paramètre de mise à jour automatique pour les applications sur l’ordinateur ou l’appareil actuel. |
| CanInstallForAllUsers |
Obtient ou définit une valeur qui indique si l’application appelante dispose de privilèges d’administration élevés pour garantir que l’installation d’une application pour tous les utilisateurs réussit. |
Méthodes
| Nom | Description |
|---|---|
| Cancel(String, String) |
Annule l’installation de l’application spécifiée, avec l’option permettant de générer des données de télémétrie. |
| Cancel(String) |
Annule l’installation de l’application spécifiée. |
| GetFreeDeviceEntitlementAsync(String, String, String) |
Accorde un droit gratuit pour l’application spécifiée à tous les utilisateurs sur l’appareil actuel. |
| GetFreeUserEntitlementAsync(String, String, String) |
Accorde un droit gratuit pour l’application spécifiée à l’utilisateur actuel. |
| GetFreeUserEntitlementForUserAsync(User, String, String, String) |
Accorde un droit gratuit pour l’application spécifiée à l’utilisateur spécifié. |
| GetIsAppAllowedToInstallAsync(String, String, String, String) |
Détermine si l’application spécifiée a l’autorisation d’installer sur l’ordinateur ou l’appareil actuel, avec l’option permettant de générer des données de télémétrie. |
| GetIsAppAllowedToInstallAsync(String) |
Détermine si l’application spécifiée a l’autorisation d’installer sur l’ordinateur ou l’appareil actuel. |
| GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String) |
Détermine si l’application spécifiée a l’autorisation d’installer sur l’ordinateur ou l’appareil actuel de l’utilisateur spécifié, avec l’option permettant de générer des données de télémétrie. |
| GetIsApplicableAsync(String, String) |
Détermine si l’application spécifiée peut être installée sur l’ordinateur ou l’appareil actuel. |
| GetIsApplicableForUserAsync(User, String, String) |
Détermine si l’application spécifiée peut être installée sur l’ordinateur ou l’appareil actuel de l’utilisateur spécifié. |
| GetIsPackageIdentityAllowedToInstallAsync(String, String, String) |
Retourne une valeur qui indique si le package avec les informations d’identité spécifiées est autorisé à être installé sur l’appareil actuel. |
| GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String) |
Retourne une valeur qui indique si le package avec les informations d’identité spécifiées est autorisé à être installé sur l’appareil actuel pour l’utilisateur spécifié. |
| IsStoreBlockedByPolicyAsync(String, String) |
Détermine si l’application spécifiée est bloquée par la stratégie sur l’ordinateur ou l’appareil actuel. |
| MoveToFrontOfDownloadQueue(String, String) |
Déplace l’application spécifiée vers l’avant de la file d’attente de téléchargement. |
| Pause(String, String) |
Suspend l’installation de l’application spécifiée, avec l’option permettant de générer des données de télémétrie. |
| Pause(String) |
Suspend l’installation de l’application spécifiée. |
| Restart(String, String) |
Redémarre l’installation de l’application spécifiée, avec l’option permettant de générer des données de télémétrie. |
| Restart(String) |
Redémarre l’installation de l’application spécifiée. |
| SearchForAllUpdatesAsync() |
Recherche toutes les mises à jour disponibles pour les applications installées sur l’ordinateur ou l’appareil actuel. |
| SearchForAllUpdatesAsync(String, String, AppUpdateOptions) |
Recherche toutes les mises à jour disponibles pour les applications installées sur l’ordinateur ou l’appareil actuel, avec la possibilité d’autoriser les redémarrages forcés de l’application et l’option permettant de générer des données de télémétrie. |
| SearchForAllUpdatesAsync(String) |
Recherche toutes les mises à jour disponibles pour les applications installées sur l’ordinateur ou l’appareil actuel, avec l’option permettant de générer des données de télémétrie. |
| SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions) |
Recherche toutes les mises à jour disponibles pour les applications installées sur l’ordinateur ou l’appareil actuel pour l’utilisateur spécifié, avec la possibilité d’autoriser les redémarrages forcés de l’application et l’option permettant de générer des données de télémétrie. |
| SearchForAllUpdatesForUserAsync(User, String) |
Recherche toutes les mises à jour disponibles pour les applications installées sur l’ordinateur ou l’appareil actuel pour l’utilisateur spécifié, avec l’option permettant de générer des données de télémétrie. |
| SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions) |
Recherche les mises à jour de l’application spécifiée, avec la possibilité d’autoriser un redémarrage forcé de l’application et l’option permettant de générer des données de télémétrie. |
| SearchForUpdatesAsync(String, String, String, String) |
Recherche les mises à jour de l’application spécifiée, avec l’option permettant de générer des données de télémétrie. |
| SearchForUpdatesAsync(String, String) |
Recherche les mises à jour de l’application spécifiée. |
| SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions) |
Recherche les mises à jour de l’application et de l’utilisateur spécifiés, avec la possibilité d’autoriser un redémarrage forcé de l’application et l’option permettant de générer des données de télémétrie. |
| SearchForUpdatesForUserAsync(User, String, String, String, String) |
Recherche les mises à jour de l’application et de l’utilisateur spécifiés, avec l’option permettant de générer des données de télémétrie. |
| StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
Note Notez que la Démarre l’installation de l’application spécifiée, avec l’option permettant de générer des données de télémétrie. |
| StartAppInstallAsync(String, String, Boolean, Boolean) |
Note Notez que la Démarre l’installation de l’application spécifiée. |
| StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
Démarre l’installation de l’application ou de l’ensemble d’applications spécifié, avec la possibilité de spécifier des options d’installation supplémentaires, telles que l’autorisation d’un redémarrage forcé de l’application. Note Évitez d’appeler Les demandes d’installation effectuées avant la fin de l’opération OOBE peuvent ne pas se comporter comme prévu, car les services associés au Windows Store peuvent ne pas encore être entièrement initialisés. Pour obtenir de meilleurs résultats, appelez ces méthodes après la première connexion utilisateur. |
| StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Démarre l’installation de l’application ou du bundle d’applications spécifié. |
| StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
Démarre l’installation de l’application ou du bundle d’applications spécifié pour l’utilisateur spécifié, avec la possibilité de spécifier des options d’installation supplémentaires, telles que l’autorisation d’un redémarrage forcé de l’application. Note Évitez d’appeler Les demandes d’installation effectuées avant la fin de l’opération OOBE peuvent ne pas se comporter comme prévu, car les services associés au Windows Store peuvent ne pas encore être entièrement initialisés. Pour obtenir de meilleurs résultats, appelez ces méthodes après la première connexion utilisateur. |
| StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Démarre l’installation de l’application ou du bundle d’applications spécifié pour l’utilisateur spécifié. |
| UpdateAppByPackageFamilyNameAsync(String, String) |
Démarre la mise à jour d’une application spécifiée par le nom de la famille de packages, avec l’option permettant de générer des données de télémétrie. |
| UpdateAppByPackageFamilyNameAsync(String) |
Démarre la mise à jour d’une application spécifiée par le nom de la famille de packages. |
| UpdateAppByPackageFamilyNameForUserAsync(User, String, String) |
Démarre la mise à jour d’une application pour un utilisateur donné spécifié par le nom de la famille de packages, avec l’option permettant de générer des données de télémétrie. |
Événements
| Nom | Description |
|---|---|
| ItemCompleted |
Se produit lorsqu’une application a terminé l’installation. |
| ItemStatusChanged |
Se produit lorsque l’état d’une application dans la file d’attente d’installation a changé. |