Skip to main content

XStoreShowGiftingUIAsync

指定した製品を別のユーザーへのギフトとして購入するための 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

ギフトとして購入する製品は、ギフト購入をサポートするように構成されている必要があります。ギフトをサポートする製品のリストを取得するには、actionFilters パラメーターを "Gift" に設定して XStoreQueryProductsAsync を呼び出します。 この関数の結果を取得するには、この関数を呼び出した後に XStoreShowGiftingUIResult を呼び出します。この関数は、ユーザーがギフトとして何かを購入することを選択したときにのみ呼び出す必要があり、支払い情報の入力とユーザー確認をプロセス外で処理するモーダル購入ダイアログをシステムに表示させます。 次のコード スニペットは、特定のストア製品のギフト購入を要求する例を示しています。

Requirements

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

See also

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