AppInstallManager.StartProductInstallAsync Methode

Definition

Namespace:

Windows.ApplicationModel.Store.Preview.InstallControl

Überlädt

StartProductInstallAsync(String, String, String, String, AppInstallOptions)	Startet die Installation der angegebenen App oder des angegebenen App-Bundles mit der Möglichkeit, zusätzliche Installationsoptionen anzugeben, z. B. ob ein erzwungener App-Neustart zugelassen werden soll.
StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume)	Startet die Installation der angegebenen App oder des angegebenen App-Bundles.

StartProductInstallAsync(String, String, String, String, AppInstallOptions)

Startet die Installation der angegebenen App oder des angegebenen App-Bundles mit der Möglichkeit, zusätzliche Installationsoptionen anzugeben, z. B. ob ein erzwungener App-Neustart zugelassen werden soll.

public:
 virtual IAsyncOperation<IVectorView<AppInstallItem ^> ^> ^ StartProductInstallAsync(Platform::String ^ productId, Platform::String ^ flightId, Platform::String ^ clientId, Platform::String ^ correlationVector, AppInstallOptions ^ installOptions) = StartProductInstallAsync;

/// [Windows.Foundation.Metadata.Overload("StartProductInstallWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<AppInstallItem>> StartProductInstallAsync(winrt::hstring const& productId, winrt::hstring const& flightId, winrt::hstring const& clientId, winrt::hstring const& correlationVector, AppInstallOptions const& installOptions);

[Windows.Foundation.Metadata.Overload("StartProductInstallWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<AppInstallItem>> StartProductInstallAsync(string productId, string flightId, string clientId, string correlationVector, AppInstallOptions installOptions);

function startProductInstallAsync(productId, flightId, clientId, correlationVector, installOptions)

Public Function StartProductInstallAsync (productId As String, flightId As String, clientId As String, correlationVector As String, installOptions As AppInstallOptions) As IAsyncOperation(Of IReadOnlyList(Of AppInstallItem))

Parameter

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

correlationVector

String

Platform::String

winrt::hstring

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

installOptions

AppInstallOptions

Stellt zusätzliche Optionen für den Vorgang bereit, 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 Asynchrone Programmierung verwenden, ist der Ergebnistyp eine schreibgeschützte Liste/ein schreibgeschützter Vektor von AppInstallItem-Elementen . (Sie können APIs von IVectorView<AppInstallItem> für C++ oder JavaScript, APIs von IReadOnlyList<AppInstallItem> für .NET verwenden.)

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

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

StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume)

Startet die Installation der angegebenen App oder des angegebenen App-Bundles.

public:
 virtual IAsyncOperation<IVectorView<AppInstallItem ^> ^> ^ StartProductInstallAsync(Platform::String ^ productId, Platform::String ^ catalogId, Platform::String ^ flightId, Platform::String ^ clientId, bool repair, bool forceUseOfNonRemovableStorage, Platform::String ^ correlationVector, PackageVolume ^ targetVolume) = StartProductInstallAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<AppInstallItem>> StartProductInstallAsync(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>> StartProductInstallAsync(string productId, string catalogId, string flightId, string clientId, bool repair, bool forceUseOfNonRemovableStorage, string correlationVector, PackageVolume targetVolume);

function startProductInstallAsync(productId, catalogId, flightId, clientId, repair, forceUseOfNonRemovableStorage, correlationVector, targetVolume)

Public Function StartProductInstallAsync (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

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

repair

Boolean

bool

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

forceUseOfNonRemovableStorage

Boolean

bool

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

correlationVector

String

Platform::String

winrt::hstring

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

targetVolume

PackageVolume

Das Paketspeichervolume, auf dem die App oder das 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 Asynchrone Programmierung verwenden, ist der Ergebnistyp eine schreibgeschützte Liste/ein schreibgeschützter Vektor von AppInstallItem-Elementen . (Sie können APIs von IVectorView<AppInstallItem> für C++ oder JavaScript, APIs von IReadOnlyList<AppInstallItem> für .NET verwenden.)

Attribute

RemoteAsyncAttribute

Windows-Anforderungen

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