AppInstallManager.StartAppInstallAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
StartAppInstallAsync(String, String, Boolean, Boolean) |
啟動指定應用程式的安裝。 |
StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
使用產生遙測資料的選項,開始安裝指定的應用程式。 |
StartAppInstallAsync(String, String, Boolean, Boolean)
啟動指定應用程式的安裝。
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)
參數
- productId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的產品識別碼。
- skuId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的 SKU 識別碼。
- repair
-
Boolean
bool
True 是表示 嘗試修復已安裝的應用程式安裝;否則為 false。
- forceUseOfNonRemovableStorage
-
Boolean
bool
True 是表示 即使使用者已將應用程式設定為安裝至 SD 記憶卡,仍會將應用程式安裝到非抽取式存放裝置;false 表示根據使用者的設定,將應用程式安裝到非抽取式存放裝置或 SD 記憶卡。
傳回
成功完成時,非同步作業會傳回 AppInstallItem ,代表已新增至安裝佇列的應用程式。
- 屬性
Windows 需求
應用程式功能 |
runFullTrust
|
備註
當此方法成功傳回時,應用程式已新增至安裝佇列;不一定表示應用程式已完成安裝。 若要判斷安裝狀態,請檢查AppInstallItem傳回值的GetCurrentStatus方法。
另請參閱
適用於
StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String)
使用產生遙測資料的選項,開始安裝指定的應用程式。
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)
參數
- productId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的產品識別碼。
- skuId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的 SKU 識別碼。
- repair
-
Boolean
bool
True 是表示 嘗試修復已安裝的應用程式安裝;否則為 false。
- forceUseOfNonRemovableStorage
-
Boolean
bool
True 是表示 即使使用者已將應用程式設定為安裝至 SD 記憶卡,仍會將應用程式安裝到非抽取式存放裝置;false 表示根據使用者的設定,將應用程式安裝到非抽取式存放裝置或 SD 記憶卡。
- catalogId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的目錄識別碼。
- bundleId
-
String
Platform::String
winrt::hstring
要安裝之應用程式的套件組合識別碼。
- correlationVector
-
String
Platform::String
winrt::hstring
可用來產生遙測資料的相互關聯向量字串。
傳回
成功完成時,非同步作業會傳回 AppInstallItem ,代表已新增至安裝佇列的應用程式。
- 屬性
Windows 需求
裝置系列 |
Windows 10 (已於 10.0.10586.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v2.0 引進)
|
應用程式功能 |
runFullTrust
|
備註
StartAppInstallAsync (String、String、Boolean、Boolean) 的備註也適用于此方法。