StoreContext.RequestDownloadStorePackageUpdatesAsync 메서드

정의

Microsoft Store 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하려고 시도합니다. 이 메서드는 작업에 대한 사용 권한을 요청하는 UI 대화 상자도 표시합니다.

중요

UI 스레드에서 이 메서드를 호출해야 합니다.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);
function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)
Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

매개 변수

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

다운로드할 업데이트된 패키지를 나타내는 개체 집합 StorePackageUpdate 입니다.

반환

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

호출자가 작업의 진행률 및 완료를 추적하기 위해 관찰할 수 있는 개체입니다. 성공적으로 완료되면 결과는 StorePackageUpdateResult 패키지 업데이트에 대한 정보를 제공하는 개체입니다.

특성

예외

예외의 ErrorCode 속성에 0x80070578(ERROR_INVALID_WINDOW_HANDLE) 값이 있는 경우 UI 스레드에서 메서드가 호출되지 않음을 나타냅니다. 데스크톱 브리지 사용하는 데스크톱 애플리케이션에서 이 메서드를 호출하는 경우 xref:Windows 구성<하지 않았음을 나타낼 수도 있습니다. 서비스. Microsoft Store. 이 메서드에 표시된 모달 대화 상자의 소유자 창인 애플리케이션 창을 지정하는 StoreContext?text=StoreContext> 개체입니다. 자세한 내용은 이 문서를 참조하세요.

설명

사용 가능한 업데이트가 있는 패키지 목록을 얻으려면 이 메서드를 GetAppAndOptionalStorePackageUpdatesAsync 사용합니다. 패키지를 다운로드한 후 메서드를 사용하여 RequestDownloadAndInstallStorePackageUpdatesAsync 설치할 수 있습니다. 코드 예제를 포함하여 이 메서드를 사용하는 방법에 대한 자세한 내용은 앱에 대한 패키지 업데이트 다운로드 및 설치를 참조하세요.

이 작업은 차단되지 않습니다. 이 메서드에서 반환된 개체는 IAsyncOperationWithProgress 업데이트 패키지를 다운로드한 후 완료됩니다.

이 메서드를 호출할 때 OS는 앱 업데이트를 다운로드할 수 있음을 사용자에게 알리고 다운로드를 진행할 수 있는 사용자의 권한을 요청하는 대화 상자를 표시합니다. 사용자가 다운로드 OverallState 를 시작할 수 있는 권한을 부여하지 않으면 반환 값의 StorePackageUpdateResult 속성에 Canceled 값이 있습니다.

알림을 처리하기 Progress 위해 할당하는 메서드는 이 요청의 각 패키지에 대한 다운로드 프로세스의 각 단계에 대해 한 번 호출됩니다. Progress 처리기는 진행률 알림을 발생시킨 업데이트 패키지에 대한 정보를 제공하는 인수를 받 StorePackageUpdateStatus 습니다.

적용 대상

추가 정보