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* 実行される非同期処理を定義する XAsyncBlock。XAsyncBlock を使用して呼び出しの状態をポーリングしたり、呼び出し結果を取得したりできます。詳細については、XAsyncBlock を参照してください。
Return value
型: HRESULT HRESULT の成功またはエラー コード。Remarks
ギフトとして購入する製品は、ギフト購入をサポートするように構成されている必要があります。ギフトをサポートする製品のリストを取得するには、actionFilters パラメーターを "Gift" に設定して XStoreQueryProductsAsync を呼び出します。
この関数の結果を取得するには、この関数を呼び出した後に XStoreShowGiftingUIResult を呼び出します。この関数は、ユーザーがギフトとして何かを購入することを選択したときにのみ呼び出す必要があり、支払い情報の入力とユーザー確認をプロセス外で処理するモーダル購入ダイアログをシステムに表示させます。
次のコード スニペットは、特定のストア製品のギフト購入を要求する例を示しています。
Requirements
ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体See also
XStoreXStoreShowGiftingUIResult
