다음을 통해 공유


StoreContext.RequestPurchaseAsync 메서드

정의

오버로드

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는 파트너 센터에서 사용할 수 있으며 앱 또는 추가 기능을 나타내는 StoreProductStoreId 속성에 의해 반환됩니다.

추가 정보

적용 대상

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는 파트너 센터에서 사용할 수 있으며 앱 또는 추가 기능을 나타내는 StoreProductStoreId 속성에 의해 반환됩니다.

추가 정보

적용 대상