Поделиться через


StoreContext.RequestDownloadAndInstallStorePackagesAsync Метод

Определение

Перегрузки

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.

Важно!

Этот метод должен вызываться в потоке пользовательского интерфейса.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.

Важно!

Этот метод должен вызываться в потоке пользовательского интерфейса.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.

Важно!

Этот метод должен вызываться в потоке пользовательского интерфейса.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function requestDownloadAndInstallStorePackagesAsync(storeIds)
Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

Параметры

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Идентификаторы магазинов устанавливаемых надстроек DLC.

Возвращаемое значение

Объект, который вызывающий объект может наблюдать для отслеживания хода выполнения и завершения операции. При успешном завершении результатом будет объект StorePackageUpdateResult , предоставляющий сведения об обновлениях пакета.

Атрибуты

Исключения

Если свойство ErrorCode исключения имеет значение 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), это означает, что метод не был вызван в потоке пользовательского интерфейса. Если вы вызываете этот метод в классическом приложении, которое использует мост для классических приложений, это также может означать, что вы не настроили <объект xref:Windows.Services.Store.StoreContext?text=StoreContext>, чтобы указать, какое окно приложения является окном-владельцем для модальных диалогов, отображаемых этим методом. Дополнительные сведения см. в этой статье.

Комментарии

Используйте этот метод для скачивания и установки новых пакетов DLC для текущего приложения. При вызове этого метода ОС отображает диалоговое окно, в котором сообщается, что пакет приложения доступен для скачивания и установки, и запрашивается разрешение пользователя на продолжение операции. Если пользователь не предоставляет разрешение, свойство OverallState возвращаемого значения StorePackageUpdateResult имеет значение Canceled. Чтобы автоматически установить пакет приложения без отображения диалогового окна уведомления, используйте DownloadAndInstallStorePackagesAsync (для этого метода требуется доступ к ограниченной возможности).

Идентификатор Магазина для надстройки DLC доступен в Центре партнеров, а также возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку DLC. Дополнительные сведения см. в разделе Идентификаторы Магазинов.

Эта операция не блокируется. Объект IAsyncOperationWithProgress , возвращенный этим методом, завершится после загрузки и установки пакетов.

Метод, назначаемый для обработки уведомлений о ходе выполнения, вызывается один раз для каждого шага в процессе загрузки и установки для каждого пакета в этом запросе. Обработчик хода выполнения получает аргумент StorePackageUpdateStatus , который предоставляет сведения о пакете, вызвавшим уведомление о ходе выполнения.

Примечание

Загружаемые пакеты содержимого (DLC) доступны не для всех учетных записей разработчиков.

См. также раздел

Применяется к

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.

Важно!

Этот метод должен вызываться в потоке пользовательского интерфейса.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);
[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);
function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)
Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

Параметры

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Идентификаторы магазинов устанавливаемых надстроек DLC.

storePackageInstallOptions
StorePackageInstallOptions

Объект , указывающий параметры установки для операции.

Возвращаемое значение

Объект, который вызывающий объект может наблюдать для отслеживания хода выполнения и завершения операции. При успешном завершении результатом будет объект StorePackageUpdateResult , предоставляющий сведения об обновлениях пакета.

Атрибуты

Исключения

Если свойство ErrorCode исключения имеет значение 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), это означает, что метод не был вызван в потоке пользовательского интерфейса. Если вы вызываете этот метод в классическом приложении, которое использует мост для классических приложений, это также может означать, что вы не настроили <объект xref:Windows.Services.Store.StoreContext?text=StoreContext>, чтобы указать, какое окно приложения является окном-владельцем для модальных диалогов, отображаемых этим методом. Дополнительные сведения см. в этой статье.

Требования к Windows

Семейство устройств
Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract
Windows.Services.Store.StoreContract (появилось в v3.0)

Комментарии

Используйте этот метод для скачивания и установки новых пакетов DLC для текущего приложения. Эта перегрузка позволяет указать, может ли ОС принудительно перезапустить приложение после установки пакетов DLC, задав свойство AllowForcedAppRestart параметра storePackageInstallOptions .

При вызове этого метода ОС отображает диалоговое окно, в котором сообщается, что пакет приложения доступен для скачивания и установки, и запрашивается разрешение пользователя на продолжение операции. Если пользователь не предоставляет разрешение, свойство OverallState возвращаемого значения StorePackageUpdateResult имеет значение Canceled. Чтобы автоматически установить пакет приложения без отображения диалогового окна уведомления, используйте DownloadAndInstallStorePackagesAsync (для этого метода требуется доступ к ограниченной возможности).

Идентификатор Магазина для надстройки DLC доступен в Центре партнеров, а также возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку DLC. Дополнительные сведения см. в разделе Идентификаторы Магазинов.

Эта операция не блокируется. Объект IAsyncOperationWithProgress , возвращенный этим методом, завершится после загрузки и установки пакетов.

Метод, назначаемый для обработки уведомлений о ходе выполнения, вызывается один раз для каждого шага в процессе загрузки и установки для каждого пакета в этом запросе. Обработчик хода выполнения получает аргумент StorePackageUpdateStatus , который предоставляет сведения о пакете, вызвавшим уведомление о ходе выполнения.

Примечание

Пакеты DLC доступны не для всех учетных записей разработчиков.

См. также раздел

Применяется к