AppInstallManager.StartAppInstallAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| StartAppInstallAsync(String, String, Boolean, Boolean) |
Starts the installation of the specified app. |
| StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
Starts the installation of the specified app, with the option to generate telemetry data. |
StartAppInstallAsync(String, String, Boolean, Boolean)
Starts the installation of the specified app.
public:
virtual IAsyncOperation<AppInstallItem ^> ^ StartAppInstallAsync(Platform::String ^ productId, Platform::String ^ skuId, bool repair, bool forceUseOfNonRemovableStorage) = StartAppInstallAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<AppInstallItem> StartAppInstallAsync(winrt::hstring const& productId, winrt::hstring const& skuId, bool const& repair, bool const& forceUseOfNonRemovableStorage);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<AppInstallItem> StartAppInstallAsync(string productId, string skuId, bool repair, bool forceUseOfNonRemovableStorage);function startAppInstallAsync(productId, skuId, repair, forceUseOfNonRemovableStorage)Public Function StartAppInstallAsync (productId As String, skuId As String, repair As Boolean, forceUseOfNonRemovableStorage As Boolean) As IAsyncOperation(Of AppInstallItem)Parameters
- productId
-
String
Platform::String
winrt::hstring
The product ID of the app to install.
- skuId
-
String
Platform::String
winrt::hstring
The SKU ID of the app to install.
- repair
-
Boolean
bool
True to attempt to repair the installation of an app that is already installed; otherwise, false.
- forceUseOfNonRemovableStorage
-
Boolean
bool
True to install the app to non-removable storage even if the user has configured apps to install to SD card; false to install the app to non-removable storage or SD card according to the user's settings.
Returns
An asynchronous operation that, on successful completion, returns an AppInstallItem that represents the app that was added to the installation queue.
- Attributes
Windows requirements
| App capabilities |
runFullTrust
|
Remarks
When this method successfully returns, the app has been added to the installation queue; it does not necessarily mean that the app has finished being installed. To determine the installation status, check the GetCurrentStatus method of the AppInstallItem return value.
See also
Applies to
StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String)
Starts the installation of the specified app, with the option to generate telemetry data.
public:
virtual IAsyncOperation<AppInstallItem ^> ^ StartAppInstallAsync(Platform::String ^ productId, Platform::String ^ skuId, bool repair, bool forceUseOfNonRemovableStorage, Platform::String ^ catalogId, Platform::String ^ bundleId, Platform::String ^ correlationVector) = StartAppInstallAsync;/// [Windows.Foundation.Metadata.Overload("StartAppInstallWithTelemetryAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<AppInstallItem> StartAppInstallAsync(winrt::hstring const& productId, winrt::hstring const& skuId, bool const& repair, bool const& forceUseOfNonRemovableStorage, winrt::hstring const& catalogId, winrt::hstring const& bundleId, winrt::hstring const& correlationVector);[Windows.Foundation.Metadata.Overload("StartAppInstallWithTelemetryAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<AppInstallItem> StartAppInstallAsync(string productId, string skuId, bool repair, bool forceUseOfNonRemovableStorage, string catalogId, string bundleId, string correlationVector);function startAppInstallAsync(productId, skuId, repair, forceUseOfNonRemovableStorage, catalogId, bundleId, correlationVector)Public Function StartAppInstallAsync (productId As String, skuId As String, repair As Boolean, forceUseOfNonRemovableStorage As Boolean, catalogId As String, bundleId As String, correlationVector As String) As IAsyncOperation(Of AppInstallItem)Parameters
- productId
-
String
Platform::String
winrt::hstring
The product ID of the app to install.
- skuId
-
String
Platform::String
winrt::hstring
The SKU ID of the app to install.
- repair
-
Boolean
bool
True to attempt to repair the installation of an app that is already installed; otherwise, false.
- forceUseOfNonRemovableStorage
-
Boolean
bool
True to install the app to non-removable storage even if the user has configured apps to install to SD card; false to install the app to non-removable storage or SD card according to the user's settings.
- catalogId
-
String
Platform::String
winrt::hstring
The catalog ID of the app to install.
- bundleId
-
String
Platform::String
winrt::hstring
The bundle ID of the app to install.
- correlationVector
-
String
Platform::String
winrt::hstring
A correlation vector string that can be used to generate telemetry data.
Returns
An asynchronous operation that, on successful completion, returns an AppInstallItem that represents the app that was added to the installation queue.
- Attributes
Windows requirements
| Device family |
Windows 10 (introduced in 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v2.0)
|
| App capabilities |
runFullTrust
|
Remarks
The remarks for StartAppInstallAsync(String, String, Boolean, Boolean) also apply to this method.