StoreContext 클래스

정의

네임스페이스:

Windows.Services.Store

현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다.

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

public ref class StoreContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Services.Store.StoreContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StoreContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Services.Store.StoreContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StoreContext

Public NotInheritable Class StoreContext

상속

Object Platform::Object IInspectable StoreContext

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Services.Store.StoreContract (v1.0에서 도입되었습니다.)

설명

참고

이 클래스와 나머지 Windows.Services.Store 네임스페이스는 Windows 10 버전 1607에서 도입되었습니다. 이 클래스는 Windows 10 Anniversary Edition을 대상으로 하는 프로젝트에서만 사용할 수 있습니다(10.0; Visual Studio에서 빌드 14393) 이상 릴리스 프로젝트가 이전 버전의 Windows 10 대상으로 하는 경우 Windows.Services.Store 네임스페이스 대신 Windows.ApplicationModel.Store 네임스페이스를 사용해야 합니다. 자세한 내용은 앱에서 바로 구매 및 평가판을 참조하세요.

StoreContext 클래스는 Windows.Services.Store 네임스페이스에 대한 기본 진입점입니다. 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보 가져오기, 앱에서 제공하는 현재 앱 또는 추가 기능 구매 또는 앱에 대한 패키지 업데이트 다운로드 및 설치와 같은 작업을 수행합니다. 이 네임스페이스의 다른 클래스 및 형식은 앱에 대한 추가 기능, 앱 라이선스 및 추가 기능, 앱에 대한 Microsoft Store 목록 정보와 같은 항목을 나타냅니다.

StoreContext 개체를 얻으려면 다음 정적 메서드 중 하나를 사용합니다.

• GetDefault: 단일 사용자 앱(즉, 앱을 시작한 사용자의 컨텍스트에서만 실행되는 앱)에서 이 메서드를 사용합니다. 이 메서드는 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. 대부분의 UWP(유니버설 Windows 플랫폼) 앱은 단일 사용자 앱입니다.

  Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
  

• GetForUser: 다중 사용자 앱에서 이 메서드를 사용합니다. 이 메서드는 특정 사용자에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. 다중 사용자 앱에 대한 자세한 내용은 다중 사용자 애플리케이션 소개를 참조하세요.

  var users = await Windows.System.User.FindAllAsync();
  Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
  

StoreContext 개체가 있으면 메서드를 호출하여 현재 사용자 및 기타 작업에 대한 앱 또는 추가 기능을 구매할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

• 앱에서 바로 구매 및 평가판
• 앱 및 추가 기능에 대한 제품 정보 가져오기
• 앱 및 추가 기능에 대한 라이선스 정보 가져오기
• 앱에서 바로 앱 및 추가 기능 구매 사용
• 소모성 추가 기능 구매 사용
• 앱의 평가판 구현

StoreContext 개체를 사용하여 앱에 대한 패키지 업데이트를 다운로드하고 설치할 수도 있습니다. 자세한 내용은 앱에 대한 패키지 업데이트 다운로드 및 설치를 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	FindStoreProductForPackageAsync
1803	17134	CanAcquireStoreLicenseAsync
1803	17134	CanAcquireStoreLicenseForOptionalPackageAsync
1803	17134	CanSilentlyDownloadStorePackageUpdates
1803	17134	DownloadAndInstallStorePackagesAsync
1803	17134	GetAssociatedStoreQueueItemsAsync
1803	17134	GetStoreProductsAsync(IEnumerable<String,IEnumerable<> String,StoreProductOptions>)
1803	17134	GetStoreQueueItemsAsync
1803	17134	RequestDownloadAndInstallStorePackagesAsync(IEnumerable<String,StorePackageInstallOptions>)
1803	17134	RequestUninstallStorePackageAsync
1803	17134	RequestUninstallStorePackageByStoreIdAsync
1803	17134	TrySilentDownloadAndInstallStorePackageUpdatesAsync
1803	17134	TrySilentDownloadStorePackageUpdatesAsync
1803	17134	UninstallStorePackageAsync
1803	17134	UninstallStorePackageByStoreIdAsync
1809	17763	RequestRateAndReviewAppAsync
1809	17763	SetInstallOrderForAssociatedStoreQueueItemsAsync

속성

CanSilentlyDownloadStorePackageUpdates	사용자에게 알림 UI를 표시하지 않고 현재 앱의 패키지 업데이트를 다운로드할 수 있는지 여부를 나타내는 값을 가져옵니다.
User	다중 사용자 앱에서 현재 StoreContext 개체와 연결된 사용자에 대한 정보를 가져옵니다.

메서드

AcquireStoreLicenseForOptionalPackageAsync(Package)	현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 추가 기능 패키지에 대한 라이선스를 획득합니다.
CanAcquireStoreLicenseAsync(String)	현재 사용자에 대해 현재 앱의 지정된 DLC(다운로드 가능한 콘텐츠) 추가 기능에 대해 라이선스를 획득할 수 있는지 여부를 나타내는 값을 가져옵니다.
CanAcquireStoreLicenseForOptionalPackageAsync(Package)	현재 사용자에 대해 현재 앱의 지정된 다운로드 가능한 콘텐츠(DLC) 패키지에 대해 라이선스를 획득할 수 있는지 여부를 나타내는 값을 가져옵니다.
DownloadAndInstallStorePackagesAsync(IIterable<String>)	사용자에게 알림 UI 대화 상자를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하고 설치합니다.
FindStoreProductForPackageAsync(IIterable<String>, Package)	지정된 패키지와 연결된 앱 또는 추가 기능에 대한 스토어 제품 세부 정보를 가져옵니다.
GetAppAndOptionalStorePackageUpdatesAsync()	앱에 대한 선택적 패키지를 포함하여 Microsoft Store에서 다운로드할 수 있는 업데이트가 있는 현재 앱의 패키지 컬렉션을 가져옵니다.
GetAppLicenseAsync()	현재 앱의 추가 기능에 대한 라이선스를 포함하여 현재 앱에 대한 라이선스 정보를 가져옵니다.
GetAssociatedStoreProductsAsync(IIterable<String>)	현재 앱 내에서 구매할 수 있는 제품에 대한 Microsoft Store 목록 정보를 가져옵니다.
GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>)	현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.
GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32)	현재 앱 내에서 구매할 수 있는 제품에 대한 Microsoft Store 목록 정보를 가져옵니다. 이 메서드는 페이징을 지원하여 결과를 반환합니다.
GetAssociatedStoreQueueItemsAsync()	현재 앱의 다운로드 및 설치 큐에 있는 모든 새 패키지 또는 업데이트된 패키지에 대한 정보를 가져옵니다.
GetConsumableBalanceRemainingAsync(String)	현재 앱에 대해 지정된 소모성 추가 기능에 대한 나머지 잔액을 가져옵니다.
GetCustomerCollectionsIdAsync(String, String)	제품 자격을 쿼리하거나 현재 사용자가 소유한 제품 자격을 사용하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다.
GetCustomerPurchaseIdAsync(String, String)	현재 사용자를 대신하여 무료 제품에 대한 권한을 부여하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다.
GetDefault()	현재 앱의 컨텍스트에서 현재 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다.
GetForUser(User)	현재 앱의 컨텍스트에서 지정된 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다.
GetStoreProductForCurrentAppAsync()	현재 앱에 대한 Microsoft Store 목록 정보를 가져오고 현재 사용자에 대한 앱을 구입하는 데 사용할 수 있는 방법에 대한 액세스를 제공합니다.
GetStoreProductsAsync(IIterable<String>, IIterable<String>)	현재 앱과 연결된 지정된 제품에 대한 Microsoft Store 목록 정보를 가져옵니다.
GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions)	쿼리에 필터를 사용하는 옵션과 함께 현재 앱과 연결된 지정된 제품에 대한 Microsoft Store 목록 정보를 가져옵니다.
GetStoreQueueItemsAsync(IIterable<String>)	현재 앱의 다운로드 및 설치 큐에 있는 지정된 새 패키지 또는 업데이트된 패키지에 대한 정보를 가져옵니다.
GetUserCollectionAsync(IIterable<String>)	사용자가 구매한 현재 앱의 추가 기능에 대한 Microsoft Store 정보를 가져옵니다.
GetUserCollectionWithPagingAsync(IIterable<String>, UInt32)	사용자가 구매한 현재 앱의 추가 기능에 대한 Microsoft Store 정보를 가져옵니다. 이 메서드는 페이징을 지원하여 결과를 반환합니다.
GetUserPurchaseHistoryAsync(IIterable<String>)	현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.
ReportConsumableFulfillmentAsync(String, UInt32, Guid)	Microsoft Store에서 처리된 현재 앱에 대한 소모성 추가 기능을 보고합니다.
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)	Microsoft Store에서 현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)	지정된 설치 옵션을 사용하여 Microsoft Store에서 현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestPurchaseAsync(String)	지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestPurchaseAsync(String, StorePurchaseProperties)	지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 이 메서드는 구매 중에 사용자에게 표시할 제품 이름을 포함하여 Microsoft Store의 단일 목록으로 표시되는 제품의 큰 카탈로그 내에서 특정 제품에 대한 추가 세부 정보를 지정하는 옵션을 제공합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestPurchaseByInAppOfferTokenAsync(String)	현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.
RequestRateAndReviewAppAsync()	사용자에게 앱을 평가하고 검토하도록 요청합니다. 이 메서드는 사용자가 스토어 등급을 선택하고 제품에 대한 선택적 스토어 검토를 추가할 수 있는 UI를 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다.
RequestUninstallStorePackageAsync(Package)	현재 앱에 대해 지정된 선택적 패키지를 제거하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다.
RequestUninstallStorePackageByStoreIdAsync(String)	현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 제거하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다.
SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>)	현재 앱의 다운로드 및 설치 큐에 지정된 패키지를 설치할 순서를 설정합니다.
TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	사용자에게 알림 UI를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하여 설치하려고 시도합니다.
TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>)	사용자에게 알림 UI를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하려고 시도합니다.
UninstallStorePackageAsync(Package)	사용자에게 알림 UI 대화 상자를 표시하지 않고 현재 앱에 대해 지정된 선택적 패키지를 제거합니다.
UninstallStorePackageByStoreIdAsync(String)	사용자에게 알림 UI 대화 상자를 표시하지 않고 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 제거합니다.

이벤트

OfflineLicensesChanged

앱 라이선스의 상태 변경될 때 발생합니다(예: 평가 기간이 만료되었거나 사용자가 앱의 전체 버전을 구매한 경우).

추가 정보

• 앱에서 바로 구매 및 평가판
• 앱에 대한 패키지 업데이트 다운로드 및 설치
• 스토어 샘플
• CoreWindow에 의존하는 WinRT UI 개체 표시