StoreContext.RequestPurchaseAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| RequestPurchaseAsync(String, StorePurchaseProperties) |
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 이 메서드는 구매 중에 사용자에게 표시할 제품 이름을 포함하여 Microsoft Store의 단일 목록으로 표시되는 제품의 큰 카탈로그 내에서 특정 제품에 대한 추가 세부 정보를 지정하는 옵션을 제공합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestPurchaseAsync(String) |
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
RequestPurchaseAsync(String, StorePurchaseProperties)
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 이 메서드는 구매 중에 사용자에게 표시할 제품 이름을 포함하여 Microsoft Store의 단일 목록으로 표시되는 제품의 큰 카탈로그 내에서 특정 제품에 대한 추가 세부 정보를 지정하는 옵션을 제공합니다.
중요
UI 스레드에서 이 메서드를 호출해야 합니다.
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId, StorePurchaseProperties ^ storePurchaseProperties) = RequestPurchaseAsync;/// [Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId, StorePurchaseProperties const& storePurchaseProperties);[Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId, StorePurchaseProperties storePurchaseProperties);function requestPurchaseAsync(storeId, storePurchaseProperties)Public Function RequestPurchaseAsync (storeId As String, storePurchaseProperties As StorePurchaseProperties) As IAsyncOperation(Of StorePurchaseResult)매개 변수
- storeId
-
String
Platform::String
winrt::hstring
앱의 스토어 ID 또는 현재 사용자에 대해 구매할 추가 기능입니다.
- storePurchaseProperties
- StorePurchaseProperties
구매 중에 사용자에게 표시할 제품 이름을 포함하여 구매 요청에 대한 추가 정보를 지정하는 개체입니다.
반환
성공적으로 완료되면 구매에 대한 상태 및 오류 정보를 제공하는 StorePurchaseResult 개체를 반환하는 비동기 작업입니다.
- 특성
예외
예외의 ErrorCode 속성에 0x80070578(ERROR_INVALID_WINDOW_HANDLE) 값이 있는 경우 UI 스레드에서 메서드가 호출되지 않았다는 것을 나타냅니다. 데스크톱 브리지 사용하는 데스크톱 애플리케이션에서 이 메서드를 호출하는 경우 이 메서드가 표시하는 모달 대화 상자의 소유자 창인 애플리케이션 창을 지정하기 위해 xref:Windows.Services.Store.StoreContext?text=StoreContext> 개체를 구성<하지 않았음을 나타낼 수도 있습니다. 자세한 내용은 이 문서를 참조하세요.
설명
앱 또는 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 앱 또는 추가 기능을 나타내는 StoreProduct의 StoreId 속성에 의해 반환됩니다.
추가 정보
적용 대상
RequestPurchaseAsync(String)
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다.
중요
UI 스레드에서 이 메서드를 호출해야 합니다.
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId) = RequestPurchaseAsync;/// [Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId);[Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId);function requestPurchaseAsync(storeId)Public Function RequestPurchaseAsync (storeId As String) As IAsyncOperation(Of StorePurchaseResult)매개 변수
- storeId
-
String
Platform::String
winrt::hstring
앱의 스토어 ID 또는 현재 사용자에 대해 구매할 추가 기능입니다.
반환
성공적으로 완료되면 구매에 대한 상태 및 오류 정보를 제공하는 StorePurchaseResult 개체를 반환하는 비동기 작업입니다.
- 특성
예외
예외의 ErrorCode 속성에 0x80070578(ERROR_INVALID_WINDOW_HANDLE) 값이 있는 경우 UI 스레드에서 메서드가 호출되지 않았다는 것을 나타냅니다. 데스크톱 브리지 사용하는 데스크톱 애플리케이션에서 이 메서드를 호출하는 경우 이 메서드가 표시하는 모달 대화 상자의 소유자 창인 애플리케이션 창을 지정하기 위해 xref:Windows.Services.Store.StoreContext?text=StoreContext> 개체를 구성<하지 않았음을 나타낼 수도 있습니다. 자세한 내용은 이 문서를 참조하세요.
설명
코드 예제를 포함하여 이 메서드를 사용하는 방법에 대한 자세한 내용은 앱 및 추가 기능의 앱에서 바로 구매 사용을 참조하세요.
앱 또는 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 앱 또는 추가 기능을 나타내는 StoreProduct의 StoreId 속성에 의해 반환됩니다.