Freigeben über

AppInstallManager.StartProductInstallForUserAsync Methode

Definition

Namespace:
Windows.ApplicationModel.Store.Preview.InstallControl

Überlädt

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

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

Bearbeiten

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.

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

Parameter

user
User

Ein Objekt, das den Benutzer angibt, der für diesen Vorgang angegeben werden soll.

productId
String

Platform::String

winrt::hstring

Die Produkt-ID der zu installierenden App.

flightId
String

Platform::String

winrt::hstring

Die Flight-ID der zu installierenden App.

clientId
String

Platform::String

winrt::hstring

Die ID des Anrufers.

correlationVector
String

Platform::String

winrt::hstring

Eine Korrelationsvektorzeichenfolge, die zum Generieren von Telemetriedaten verwendet werden kann.

installOptions
AppInstallOptions

Bietet zusätzliche Optionen für den Vorgang, einschließlich der Möglichkeit, einen erzwungenen App-Neustart zuzulassen.

Gibt zurück

IAsyncOperation<IVectorView<AppInstallItem>>

IAsyncOperation<IReadOnlyList<AppInstallItem>>

Ein asynchroner Vorgang, der nach erfolgreichem Abschluss die App oder den Satz von Apps (für ein App-Bündel) zurückgibt, die der Installationswarteschlange hinzugefügt wurden. Wenn Sie die asynchrone Programmierung verwenden, ist der Ergebnistyp eine schreibgeschützte Liste/ein Vektor von AppInstallItem-Elementen . (Sie können APIs von IVectorView<AppInstallItem> für C++ oder JavaScript verwenden, APIs von IReadOnlyList<AppInstallItem> für .NET.)

Attribute
OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)
App-Funktionen
runFullTrust

Gilt für:

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

Bearbeiten

Startet die Installation des angegebenen App- oder App-Bündels für den angegebenen Benutzer.

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

Parameter

user
User

Ein Objekt, das den Benutzer angibt, der für diesen Vorgang angegeben werden soll.

productId
String

Platform::String

winrt::hstring

Die Produkt-ID der zu installierenden App.

catalogId
String

Platform::String

winrt::hstring

Die Katalog-ID der zu installierenden App.

flightId
String

Platform::String

winrt::hstring

Die Flight-ID der zu installierenden App.

clientId
String

Platform::String

winrt::hstring

Die ID des Anrufers.

repair
Boolean

bool

True, um zu versuchen, die Installation einer bereits installierten App zu reparieren; andernfalls "false".

forceUseOfNonRemovableStorage
Boolean

bool

True, um die App auf nicht wechselbaren Speicher zu installieren, auch wenn der Benutzer Apps für die Installation auf SD-Karte konfiguriert hat; false, um die App gemäß den Einstellungen des Benutzers auf nicht wechselbaren Speicher oder SD-Karten zu installieren.

correlationVector
String

Platform::String

winrt::hstring

Eine Korrelationsvektorzeichenfolge, die zum Generieren von Telemetriedaten verwendet werden kann.

targetVolume
PackageVolume

Das Paketspeichervolume, auf dem das App- oder App-Bündel installiert wird.

Gibt zurück

IAsyncOperation<IVectorView<AppInstallItem>>

IAsyncOperation<IReadOnlyList<AppInstallItem>>

Ein asynchroner Vorgang, der nach erfolgreichem Abschluss die App oder den Satz von Apps (für ein App-Bündel) zurückgibt, die der Installationswarteschlange hinzugefügt wurden. Wenn Sie die asynchrone Programmierung verwenden, ist der Ergebnistyp eine schreibgeschützte Liste/ein Vektor von AppInstallItem-Elementen . (Sie können APIs von IVectorView<AppInstallItem> für C++ oder JavaScript verwenden, APIs von IReadOnlyList<AppInstallItem> für .NET.)

Attribute
RemoteAsyncAttribute

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
App-Funktionen
runFullTrust

Gilt für: