Skip to main content

XStoreQueryProductsAsync

傳回與目前遊戲相關聯之指定產品的清單資訊,無論這些產品是否可在遊戲內購買。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
由 XStoreCreateContext 傳回的使用者市集內容控制代碼。 productKinds   _In_
類型:XStoreProductKind
要傳回的產品類型。 storeIds   _In_z_count_(storeIdsCount)
類型:char**
要擷取之產品的市集識別碼。 storeIdsCount   _In_
類型:size_t
storeIds 清單中的產品數目。 此數目不應超過 100。 actionFilters   _In_opt_z_count_(actionFiltersCount)
類型:char**
依據產品文件中儲存的某個動作來限制結果。 根據預設,此 API 會傳回所有產品,即使產品無法購買也一樣,但您可以使用動作篩選條件來限制結果。 例如,如果您只想要可購買的產品,請使用 “Purchase”;如果您只想要可授權的產品,請使用 “License”。 其他動作篩選條件包括 “Fulfill”、“Browse”、“Curate”、“Details” 和 “Redeem”。 actionFiltersCount   _In_
類型:size_t
actionFilters 中的篩選條件數目。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。 使用 XAsyncBlock 檢查呼叫的狀態並取得結果。 如需詳細資訊,請參閱 XAsyncBlock。

傳回值

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

備註

呼叫 XStoreQueryProductsResult 以擷取清單資訊和此函式的執行結果。 如果您在要求中提供超過 100 個 storeID,此 API 就會失敗。 如果您使用的是大型目錄,請將每個查詢限制在少於 100 個產品。 若要取得玩家可在目前遊戲內購買之所有產品的詳細資料,請改用 XStoreQueryAssociatedProductsAsync。 下列程式碼片段示範擷取與目前遊戲相關聯之指定產品清單資訊的範例。

需求

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

概念文件

另請參閱

XStore XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
基本市集作業
授與玩家附加元件內容的存取權
Last modified on October 6, 2026