Skip to main content

XStoreShowPurchaseUIAsync

為指定的產品開始購買 UI 覆疊。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
由 XStoreCreateContext 傳回的使用者商店內容控制代碼。 storeId   _In_z_
類型:char*
要購買之產品的識別碼。 name   _In_opt_z_
類型:char*
要購買之產品的名稱。 extendedJsonData   _In_opt_z_
類型:char*
傳遞給購買流程的 JSON Blob。可讓您插入自訂行銷活動識別碼,以便追蹤購買是如何開始的。 async   _Inout_
類型:XAsyncBlock*
定義正在執行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

![NOTE] 此作業不會在預期的購買之後觸發項目的下載或安裝。如果您想要下載並安裝此內容,建議在購買成功後呼叫 XStoreDownloadAndInstallPackagesAsync。系統不會再向使用者顯示其他提示。
![NOTE] 在 PC 上,購買成功後顯示的購買確認對話方塊頂端會有關閉按鈕 [X]。選取此按鈕而非 [確定],會導致 XStoreShowPurchaseUIResult 傳回 E_ABORT,這可能不是您想要的結果。這是以此方式關閉任何對話方塊時的標準 Windows 行為。
若要擷取此函式的結果,請在呼叫此函式之後呼叫 XStoreShowPurchaseUIResult。只有在使用者選擇購買某項內容時才應呼叫此函式,此函式會使系統顯示強制回應購買對話方塊,在處理序外處理付款資訊和使用者確認。 下列程式碼片段示範針對特定商店產品要求購買的範例。

需求

標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XStore
XStoreShowPurchaseUIResult
Last modified on October 6, 2026