Skip to main content

XStoreShowPurchaseUIAsync

指定した製品の購入 UI オーバーレイを開始します。

Syntax

Parameters

storeContextHandle   _In_
型: XStoreContextHandle
XStoreCreateContext によって返されたユーザーのストア コンテキスト ハンドル。 storeId   _In_z_
型: char*
購入する製品の ID。 name   _In_opt_z_
型: char*
購入する製品の名前。 extendedJsonData   _In_opt_z_
型: char*
購入フローに渡される JSON ブロブ。カスタム キャンペーン ID を挿入できるため、購入の開始経路を追跡できます。 async   _Inout_
型: XAsyncBlock*
実行される非同期処理を定義する XAsyncBlockXAsyncBlock を使用して呼び出しの状態をポーリングしたり、呼び出し結果を取得したりできます。詳細については、XAsyncBlock を参照してください。

Return value

型: HRESULT HRESULT の成功またはエラー コード。

Remarks

![NOTE] この操作では、購入が想定されている場合でも、その後にアイテムのダウンロードやインストールは行われません。このコンテンツをダウンロードおよびインストールしたい場合は、購入が成功した後に XStoreDownloadAndInstallPackagesAsync を呼び出すことをお勧めします。ユーザーに追加のプロンプトは表示されません。
![NOTE] PC では、購入が成功した後に表示される購入確認ダイアログの上部に閉じるボタン [X] が表示されます。[OK] の代わりにこれを選択すると XStoreShowPurchaseUIResult に E_ABORT が返され、意図しない結果になる可能性があります。これはダイアログがこの方法で閉じられたときの Windows の標準動作です。
この関数の結果を取得するには、この関数を呼び出した後に XStoreShowPurchaseUIResult を呼び出します。この関数は、ユーザーが何かを購入することを選択したときにのみ呼び出す必要があり、支払い情報とユーザーの確認をプロセス外で処理するモーダル購入ダイアログをシステムに表示させます。 次のコード スニペットは、特定のストア製品の購入を要求する例を示しています。

Requirements

ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XStore
XStoreShowPurchaseUIResult
最終更新日 2026年8月24日