XStoreShowRedeemTokenUIAsync
為目前使用者觸發指定權杖的兌換。語法
參數
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* 定義正在執行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
若要擷取此函式的執行結果,請在呼叫此函式之後呼叫 XStoreShowRedeemTokenUIResult。 下列程式碼片段示範啟動權杖兌換 UI 的範例。需求
標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
XStoreXStoreShowRedeemTokenUIResult
