AppInstallManager.StartProductInstallForUserAsync Méthode
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.
Surcharges
| Nom | Description |
|---|---|
| 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é. |
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 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.
public:
virtual IAsyncOperation<IVectorView<AppInstallItem ^> ^> ^ StartProductInstallForUserAsync(User ^ user, Platform::String ^ productId, Platform::String ^ flightId, Platform::String ^ clientId, Platform::String ^ correlationVector, AppInstallOptions ^ installOptions) = StartProductInstallForUserAsync;
/// [Windows.Foundation.Metadata.Overload("StartProductInstallWithOptionsForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<AppInstallItem>> StartProductInstallForUserAsync(User const& user, winrt::hstring const& productId, winrt::hstring const& flightId, winrt::hstring const& clientId, winrt::hstring const& correlationVector, AppInstallOptions const& installOptions);
[Windows.Foundation.Metadata.Overload("StartProductInstallWithOptionsForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<AppInstallItem>> StartProductInstallForUserAsync(User user, string productId, string flightId, string clientId, string correlationVector, AppInstallOptions installOptions);
function startProductInstallForUserAsync(user, productId, flightId, clientId, correlationVector, installOptions)
Public Function StartProductInstallForUserAsync (user As User, productId As String, flightId As String, clientId As String, correlationVector As String, installOptions As AppInstallOptions) As IAsyncOperation(Of IReadOnlyList(Of AppInstallItem))
Paramètres
- user
- User
Objet qui identifie l’utilisateur à spécifier pour cette opération.
- productId
-
String
Platform::String
winrt::hstring
ID de produit de l’application à installer.
- flightId
-
String
Platform::String
winrt::hstring
ID de version d’évaluation de l’application à installer.
- clientId
-
String
Platform::String
winrt::hstring
ID de l’appelant.
- correlationVector
-
String
Platform::String
winrt::hstring
Chaîne de vecteur de corrélation qui peut être utilisée pour générer des données de télémétrie.
- installOptions
- AppInstallOptions
Fournit des options supplémentaires pour l’opération, notamment la possibilité d’autoriser un redémarrage forcé de l’application.
Retours
Une opération asynchrone qui, en cas de réussite, retourne l’application ou l’ensemble d’applications (pour un ensemble d’applications) qui ont été ajoutées à la file d’attente d’installation. Si vous utilisez la programmation asynchrone, le type de résultat est une liste/vecteur en lecture seule d’éléments AppInstallItem . (Vous pouvez utiliser des API de IVectorView<AppInstallItem> pour C++ ou JavaScript, API de IReadOnlyList<AppInstallItem> pour .NET.)
- Attributs
Configuration requise pour Windows
| Configuration requise | Description |
|---|---|
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v6.0)
|
| Fonctionnalités de l’application |
runFullTrust
|
S’applique à
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é.
public:
virtual IAsyncOperation<IVectorView<AppInstallItem ^> ^> ^ StartProductInstallForUserAsync(User ^ user, Platform::String ^ productId, Platform::String ^ catalogId, Platform::String ^ flightId, Platform::String ^ clientId, bool repair, bool forceUseOfNonRemovableStorage, Platform::String ^ correlationVector, PackageVolume ^ targetVolume) = StartProductInstallForUserAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<AppInstallItem>> StartProductInstallForUserAsync(User const& user, winrt::hstring const& productId, winrt::hstring const& catalogId, winrt::hstring const& flightId, winrt::hstring const& clientId, bool const& repair, bool const& forceUseOfNonRemovableStorage, winrt::hstring const& correlationVector, PackageVolume const& targetVolume);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<AppInstallItem>> StartProductInstallForUserAsync(User user, string productId, string catalogId, string flightId, string clientId, bool repair, bool forceUseOfNonRemovableStorage, string correlationVector, PackageVolume targetVolume);
function startProductInstallForUserAsync(user, productId, catalogId, flightId, clientId, repair, forceUseOfNonRemovableStorage, correlationVector, targetVolume)
Public Function StartProductInstallForUserAsync (user As User, productId As String, catalogId As String, flightId As String, clientId As String, repair As Boolean, forceUseOfNonRemovableStorage As Boolean, correlationVector As String, targetVolume As PackageVolume) As IAsyncOperation(Of IReadOnlyList(Of AppInstallItem))
Paramètres
- user
- User
Objet qui identifie l’utilisateur à spécifier pour cette opération.
- productId
-
String
Platform::String
winrt::hstring
ID de produit de l’application à installer.
- catalogId
-
String
Platform::String
winrt::hstring
ID de catalogue de l’application à installer.
- flightId
-
String
Platform::String
winrt::hstring
ID de version d’évaluation de l’application à installer.
- clientId
-
String
Platform::String
winrt::hstring
ID de l’appelant.
- repair
-
Boolean
bool
True pour tenter de réparer l’installation d’une application déjà installée ; sinon, false.
- forceUseOfNonRemovableStorage
-
Boolean
bool
True pour installer l’application dans un stockage non amovible, même si l’utilisateur a configuré des applications pour l’installer sur une carte SD ; false pour installer l’application dans un stockage non amovible ou une carte SD en fonction des paramètres de l’utilisateur.
- correlationVector
-
String
Platform::String
winrt::hstring
Chaîne de vecteur de corrélation qui peut être utilisée pour générer des données de télémétrie.
- targetVolume
- PackageVolume
Volume de stockage de package où l’application ou l’offre groupée d’applications sera installée.
Retours
Une opération asynchrone qui, en cas de réussite, retourne l’application ou l’ensemble d’applications (pour un ensemble d’applications) qui ont été ajoutées à la file d’attente d’installation. Si vous utilisez la programmation asynchrone, le type de résultat est une liste/vecteur en lecture seule d’éléments AppInstallItem . (Vous pouvez utiliser des API de IVectorView<AppInstallItem> pour C++ ou JavaScript, API de IReadOnlyList<AppInstallItem> pour .NET.)
- Attributs
Configuration requise pour Windows
| Configuration requise | Description |
|---|---|
| Famille d’appareils |
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v3.0)
|
| Fonctionnalités de l’application |
runFullTrust
|