XStoreCanAcquireLicenseForStoreIdAsync
擷取可授權內容的預覽授權,包括含或不含套件的耐久性產品,以及目前已插入之光碟上的內容。 此 API 可讓遊戲查看產品是否可授權,但不會實際取得授權。語法
參數
storeContextHandle _In_類型:XStoreContextHandle 使用者的市集內容控制代碼,由 XStoreCreateContext 傳回。 storeProductId _In_z_
類型:char* 要檢查之產品的 StoreID async _Inout_
類型:XAsyncBlock* 定義正在進行之非同步工作的 XAsyncBlock。 XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。 如需詳細資訊,請參閱 XAsyncBlock。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
XStoreCanAcquireLicenseForStoreIdAsync 讓遊戲能夠判斷使用者是否可以取得特定內容的授權,而不需實際取得該授權並佔用該使用者的並行位置。 此函式不需要用於目前正在執行的遊戲,因為它已經擁有授權,但可以用來判斷使用者是否擁有相同發行者的其他遊戲或內容。 例如,遊戲可以使用此 API 來判斷是否要獎勵擁有該遊戲先前版本 (數位版或已插入的光碟) 的使用者,或向使用者推銷升級產品。 若要擷取預覽授權及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreCanAcquireLicenseForStoreIdResult。 此程式碼片段示範如何使用下列 API:- XStoreCanAcquireLicenseForStoreIdAsync
- XStoreCanAcquireLicenseForStoreIdResult
需求
標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XStoreXStoreCanAcquireLicenseForStoreIdResult
如何使用不含套件的耐久性產品
授予玩家附加元件內容的存取權
