Condividi tramite

AppInstallManager.StartProductInstallForUserAsync Metodo

Definizione

Spazio dei nomi:
Windows.ApplicationModel.Store.Preview.InstallControl

Overload

Nome Descrizione
StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions)

Avvia l'installazione dell'app o del bundle di app specificato per l'utente specificato, con la possibilità di specificare opzioni di installazione aggiuntive, ad esempio se consentire un riavvio forzato dell'app.

Annotazioni

Evitare di chiamare AppInstallManager.StartProductInstallAsync o AppInstallManager.StartProductInstallForUserAsync durante la configurazione guidata di Windows.

Le richieste di installazione effettuate prima del completamento della configurazione guidata potrebbero non comportarsi come previsto perché i servizi correlati allo Store potrebbero non essere ancora completamente inizializzati.

Per ottenere risultati ottimali, chiamare questi metodi dopo il primo accesso dell'utente.
StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume)

Avvia l'installazione dell'app o del bundle dell'app specificato per l'utente specificato.

StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions)

Modifica

Avvia l'installazione dell'app o del bundle di app specificato per l'utente specificato, con la possibilità di specificare opzioni di installazione aggiuntive, ad esempio se consentire un riavvio forzato dell'app.

Annotazioni

Evitare di chiamare AppInstallManager.StartProductInstallAsync o AppInstallManager.StartProductInstallForUserAsync durante la configurazione guidata di Windows.

Le richieste di installazione effettuate prima del completamento della configurazione guidata potrebbero non comportarsi come previsto perché i servizi correlati allo Store potrebbero non essere ancora completamente inizializzati.

Per ottenere risultati ottimali, chiamare questi metodi dopo il primo accesso dell'utente.

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

Parametri

user
User

Oggetto che identifica l'utente da specificare per questa operazione.

productId
String

Platform::String

winrt::hstring

ID prodotto dell'app da installare.

flightId
String

Platform::String

winrt::hstring

ID anteprima dell'app da installare.

clientId
String

Platform::String

winrt::hstring

ID del chiamante.

correlationVector
String

Platform::String

winrt::hstring

Stringa del vettore di correlazione che può essere usata per generare dati di telemetria.

installOptions
AppInstallOptions

Offre opzioni aggiuntive per l'operazione, inclusa la possibilità di consentire un riavvio forzato dell'app.

Valori restituiti

IAsyncOperation<IVectorView<AppInstallItem>>

IAsyncOperation<IReadOnlyList<AppInstallItem>>

Operazione asincrona che, al completamento corretto, restituisce l'app o il set di app (per un bundle di app) aggiunto alla coda di installazione. Se si usa la programmazione asincrona, il tipo di risultato è un elenco di sola lettura/vettore di elementi AppInstallItem . È possibile usare le API di IVectorView<AppInstallItem> per C++ o JavaScript, API di IReadOnlyList<AppInstallItem> per .NET.

Attributi
OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Requisiti Descrizione
Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)
Funzionalità dell'app
runFullTrust

Si applica a

StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume)

Modifica

Avvia l'installazione dell'app o del bundle dell'app specificato per l'utente specificato.

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

Parametri

user
User

Oggetto che identifica l'utente da specificare per questa operazione.

productId
String

Platform::String

winrt::hstring

ID prodotto dell'app da installare.

catalogId
String

Platform::String

winrt::hstring

ID catalogo dell'app da installare.

flightId
String

Platform::String

winrt::hstring

ID anteprima dell'app da installare.

clientId
String

Platform::String

winrt::hstring

ID del chiamante.

repair
Boolean

bool

True per tentare di ripristinare l'installazione di un'app già installata; in caso contrario, false.

forceUseOfNonRemovableStorage
Boolean

bool

True per installare l'app in una risorsa di archiviazione non rimovibile anche se l'utente ha configurato le app da installare nella scheda SD; false per installare l'app in un archivio non rimovibile o in una scheda SD in base alle impostazioni dell'utente.

correlationVector
String

Platform::String

winrt::hstring

Stringa del vettore di correlazione che può essere usata per generare dati di telemetria.

targetVolume
PackageVolume

Volume di archiviazione del pacchetto in cui verrà installato l'app o il bundle dell'app.

Valori restituiti

IAsyncOperation<IVectorView<AppInstallItem>>

IAsyncOperation<IReadOnlyList<AppInstallItem>>

Operazione asincrona che, al completamento corretto, restituisce l'app o il set di app (per un bundle di app) aggiunto alla coda di installazione. Se si usa la programmazione asincrona, il tipo di risultato è un elenco di sola lettura/vettore di elementi AppInstallItem . È possibile usare le API di IVectorView<AppInstallItem> per C++ o JavaScript, API di IReadOnlyList<AppInstallItem> per .NET.

Attributi
RemoteAsyncAttribute

Requisiti Windows

Requisiti Descrizione
Famiglia di dispositivi
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
Funzionalità dell'app
runFullTrust

Si applica a