Skip to main content

XStoreQueryAddOnLicensesAsync

列舉附加至數位遊戲授權之任何耐久性附加元件的授權。 這僅適用於不含套件類型的耐久性項目,而且只能搭配數位授權使用,不能搭配光碟授權使用。 使用光碟授權執行此函式會得到空白結果,即使存在使用者所擁有或可授權的個別耐久性項目也是如此。 針對光碟案例,請改用 XStoreAcquireLicenseForDurablesAsync。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
XStoreCreateContext 所傳回之使用者的市集內容控制代碼。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。 XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

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

備註

若要擷取附加元件授權以及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreQueryAddonLicensesResult。 若要擷取此函式取得的授權數目,請在呼叫此函式之後呼叫 XStoreQueryAddonLicensesResultCount。 結果計數函式很重要,因為它可讓您判斷要傳遞給結果函式的適當陣列大小。 下列程式碼片段示範如何擷取使用者擁有或可授權的耐久性附加元件授權 (不含套件):

需求

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

概念文件

另請參閱

XStore
XStoreQueryAddonLicensesResult
XStoreQueryAddonLicensesResultCount
Last modified on October 6, 2026