Langue

AppInstallManager.StartProductInstallForUserAsync Méthode

Définition

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 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.

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

S’applique à