Skip to main content

XStoreShowRedeemTokenUIAsync

指定したトークンに対して、現在のユーザーによるトークンの引き換えをトリガーします。

Syntax

Parameters

storeContextHandle   _In_
型: XStoreContextHandle
XStoreCreateContext によって返されたユーザーのストア コンテキスト ハンドル。 token   _In_z_
型: char*
引き換えるトークン。この値を空または null にすることはできません。UI に事前入力するコードを指定せずに UI を表示したい場合は、単一のスペース ” ” を渡してください。 allowedStoreIds   _In_z_count_(allowedStoreIdsCount)
型: char**
5x5 コードを特定の製品のみで機能するように制限できます。 allowedStoreIdsCount   _In_
型: size_t
allowedStoreIds 内の要素数。 disallowCsvRedemption   _In_
型: bool
CSV (ギフト カード / 通貨形式の 5x5) の引き換えを防ぎます。 async   _Inout_
型: XAsyncBlock*
実行される非同期処理を定義する XAsyncBlockXAsyncBlock を使用して呼び出しの状態をポーリングしたり、呼び出し結果を取得したりできます。詳細については、XAsyncBlock を参照してください。

Return value

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

Remarks

この関数の実行結果を取得するには、この関数を呼び出した後に XStoreShowRedeemTokenUIResult を呼び出します。 次のコード スニペットは、トークン引き換え UI を起動する例を示しています。

Requirements

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

See also

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