XStoreAcquireLicenseForPackageAsync
為使用者有權使用的目前遊戲,取得已安裝 DLC 套件 (含套件的耐久性產品類型) 的授權。 XStoreRegisterPackageLicenseLost 可用來監視從此 API 取得的授權是否遺失。此 API 不適用於不含套件的耐久性附加元件。
語法
參數
storeContextHandle _In_類型:XStoreContextHandle 使用者的市集內容控制代碼,由 XStoreCreateContext 傳回。 packageIdentifier _In_z_
類型:char* 唯一識別市集套件的字串。套件識別碼通常會在 XPackageEnumeratePackages 作業中傳回。如需套件識別碼的詳細資訊,請參閱管理及授權可下載內容 (DLC)。 async _Inout_
類型:XAsyncBlock* 定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
若要擷取套件授權及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreAcquireLicenseForPackageResult。 如果您想要檢查套件是否可以授權,請呼叫 XStoreCanAcquireLicenseForPackageAsync。 取得授權之後,您必須呼叫 XStoreIsLicenseValid 來檢查授權是否有效。 XPackageMountWithUiAsync 在呼叫時會自動取得授權。 如果無法取得授權,套件就會掛接失敗。 此程式碼片段示範如何使用下列 API:- XStoreAcquireLicenseForPackageAsync
- XStoreAcquireLicenseForPackageResult
- XStoreIsLicenseValid
- XStoreCloseLicenseHandle
- XStoreRegisterPackageLicenseLost
- XStoreUnregisterPackageLicenseLost
需求
標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
管理及授權可下載內容 (DLC)
