StoreContext.RequestDownloadAndInstallStorePackagesAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 이 메서드는 UI 스레드에서 호출해야 합니다. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
지정된 설치 옵션을 사용하여 Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 이 메서드는 UI 스레드에서 호출해야 합니다. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다.
중요
이 메서드는 UI 스레드에서 호출해야 합니다.
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)매개 변수
반환
호출자가 작업의 진행률 및 완료를 추적하기 위해 관찰할 수 있는 개체입니다. 성공적으로 완료되면 패키지 업데이트에 대한 정보를 제공하는 StorePackageUpdateResult 개체가 생성됩니다.
- 특성
예외
예외의 ErrorCode 속성에 0x80070578(ERROR_INVALID_WINDOW_HANDLE) 값이 있는 경우 UI 스레드에서 메서드가 호출되지 않음을 나타냅니다. 데스크톱 브리지 사용하는 데스크톱 애플리케이션에서 이 메서드를 호출하는 경우 이 메서드가 표시하는 모달 대화 상자의 소유자 창인 애플리케이션 창을 지정하기 위해 xref:Windows.Services.Store.StoreContext?text=StoreContext> 개체를 구성<하지 않았음을 나타낼 수도 있습니다. 자세한 내용은 이 문서를 참조하세요.
설명
이 메서드를 사용하여 현재 앱에 대한 새 DLC 패키지를 다운로드하고 설치합니다. 이 메서드를 호출하면 OS는 앱 패키지를 다운로드 및 설치할 수 있음을 사용자에게 알리고 작업을 진행할 수 있는 권한을 사용자에게 요청하는 대화 상자를 표시합니다. 사용자가 권한을 부여하지 않으면 StorePackageUpdateResult 반환 값의 OverallState 속성에 Canceled 값이 있습니다. 알림 대화 상자를 표시하지 않고 앱 패키지를 자동으로 설치하려면 DownloadAndInstallStorePackagesAsync 를 사용합니다(이 메서드는 제한된 기능에 액세스해야 합니다).
DLC 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 DLC 추가 기능을 나타내는 StoreProduct의 StoreId 속성에서도 반환됩니다. 자세한 내용은 스토어 ID를 참조하세요.
이 작업은 차단되지 않습니다. 패키지를 다운로드하고 설치한 후 이 메서드에서 반환된 IAsyncOperationWithProgress 개체가 완료됩니다.
진행률 알림을 처리하기 위해 할당하는 메서드는 이 요청의 각 패키지에 대한 다운로드 및 설치 프로세스의 각 단계에 대해 한 번 호출됩니다. Progress 처리기는 진행률 알림을 발생시킨 패키지에 대한 정보를 제공하는 StorePackageUpdateStatus 인수를 받습니다.
참고
DLC(다운로드 가능한 콘텐츠) 패키지는 모든 개발자 계정에서 사용할 수 없습니다.
추가 정보
적용 대상
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
지정된 설치 옵션을 사용하여 Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다.
중요
이 메서드는 UI 스레드에서 호출해야 합니다.
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)매개 변수
- storePackageInstallOptions
- StorePackageInstallOptions
작업에 대한 설치 옵션을 지정하는 개체입니다.
반환
호출자가 작업의 진행률 및 완료를 추적하기 위해 관찰할 수 있는 개체입니다. 성공적으로 완료되면 패키지 업데이트에 대한 정보를 제공하는 StorePackageUpdateResult 개체가 생성됩니다.
- 특성
예외
예외의 ErrorCode 속성에 0x80070578(ERROR_INVALID_WINDOW_HANDLE) 값이 있는 경우 UI 스레드에서 메서드가 호출되지 않음을 나타냅니다. 데스크톱 브리지 사용하는 데스크톱 애플리케이션에서 이 메서드를 호출하는 경우 이 메서드가 표시하는 모달 대화 상자의 소유자 창인 애플리케이션 창을 지정하기 위해 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 패키지를 다운로드하고 설치합니다. 이 오버로드는 storePackageInstallOptions 매개 변수의 AllowForcedAppRestart 속성을 설정하여 OS가 DLC 패키지를 설치한 후 앱을 강제로 다시 시작할 수 있는지 여부를 지정하는 옵션을 제공합니다.
이 메서드를 호출하면 OS는 앱 패키지를 다운로드 및 설치할 수 있음을 사용자에게 알리고 작업을 진행할 수 있는 권한을 사용자에게 요청하는 대화 상자를 표시합니다. 사용자가 권한을 부여하지 않으면 StorePackageUpdateResult 반환 값의 OverallState 속성에 Canceled 값이 있습니다. 알림 대화 상자를 표시하지 않고 앱 패키지를 자동으로 설치하려면 DownloadAndInstallStorePackagesAsync 를 사용합니다(이 메서드는 제한된 기능에 액세스해야 합니다).
DLC 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 DLC 추가 기능을 나타내는 StoreProduct의 StoreId 속성에서도 반환됩니다. 자세한 내용은 스토어 ID를 참조하세요.
이 작업은 차단되지 않습니다. 패키지를 다운로드하고 설치한 후 이 메서드에서 반환된 IAsyncOperationWithProgress 개체가 완료됩니다.
진행률 알림을 처리하기 위해 할당하는 메서드는 이 요청의 각 패키지에 대한 다운로드 및 설치 프로세스의 각 단계에 대해 한 번 호출됩니다. Progress 처리기는 진행률 알림을 발생시킨 패키지에 대한 정보를 제공하는 StorePackageUpdateStatus 인수를 받습니다.
참고
DLC 패키지는 모든 개발자 계정에서 사용할 수 없습니다.
추가 정보
적용 대상
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기