StoreContext.RequestPurchaseAsync 메서드

  • 참조

정의

네임스페이스:
Windows.Services.Store

오버로드

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

구매 중에 사용자에게 표시할 제품 이름을 포함하여 구매 요청에 대한 추가 정보를 지정하는 개체입니다.

반환

IAsyncOperation<StorePurchaseResult>

성공적으로 완료되면 구매에 대한 상태 및 오류 정보를 제공하는 StorePurchaseResult 개체를 반환하는 비동기 작업입니다.

특성
OverloadAttribute RemoteAsyncAttribute

예외

COMException

예외의 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 또는 현재 사용자에 대해 구매할 추가 기능입니다.

반환

IAsyncOperation<StorePurchaseResult>

성공적으로 완료되면 구매에 대한 상태 및 오류 정보를 제공하는 StorePurchaseResult 개체를 반환하는 비동기 작업입니다.

특성
OverloadAttribute RemoteAsyncAttribute

예외

COMException

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

설명

코드 예제를 포함하여 이 메서드를 사용하는 방법에 대한 자세한 내용은 앱 및 추가 기능의 앱에서 바로 구매 사용을 참조하세요.

앱 또는 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 앱 또는 추가 기능을 나타내는 StoreProduct의 StoreId 속성에 의해 반환됩니다.

추가 정보

적용 대상