Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

擷取可授權內容的預覽授權,包括含或不含套件的耐久性產品,以及目前已插入之光碟上的內容。 此 API 可讓遊戲查看產品是否可授權,但不會實際取得授權。

語法

參數

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

傳回值

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

備註

XStoreCanAcquireLicenseForStoreIdAsync 讓遊戲能夠判斷使用者是否可以取得特定內容的授權,而不需實際取得該授權並佔用該使用者的並行位置。 此函式不需要用於目前正在執行的遊戲,因為它已經擁有授權,但可以用來判斷使用者是否擁有相同發行者的其他遊戲或內容。 例如,遊戲可以使用此 API 來判斷是否要獎勵擁有該遊戲先前版本 (數位版或已插入的光碟) 的使用者,或向使用者推銷升級產品。 若要擷取預覽授權及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreCanAcquireLicenseForStoreIdResult。 此程式碼片段示範如何使用下列 API:

需求

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

概念文件

另請參閱

XStore
XStoreCanAcquireLicenseForStoreIdResult
如何使用不含套件的耐久性產品
授予玩家附加元件內容的存取權
Last modified on October 6, 2026