Skip to main content

XStoreAcquireLicenseForPackageAsync

為使用者有權使用的目前遊戲,取得已安裝 DLC 套件 (含套件的耐久性產品類型) 的授權。 XStoreRegisterPackageLicenseLost 可用來監視從此 API 取得的授權是否遺失。
此 API 不適用於不含套件的耐久性附加元件。
若要取得不含套件之耐久性產品的授權,請使用 XStoreAcquireLicenseForDurablesAsync。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
使用者的市集內容控制代碼,由 XStoreCreateContext 傳回。 packageIdentifier   _In_z_
類型:char*
唯一識別市集套件的字串。套件識別碼通常會在 XPackageEnumeratePackages 作業中傳回。如需套件識別碼的詳細資訊,請參閱管理及授權可下載內容 (DLC)。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

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

備註

若要擷取套件授權及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreAcquireLicenseForPackageResult。 如果您想要檢查套件是否可以授權,請呼叫 XStoreCanAcquireLicenseForPackageAsync。 取得授權之後,您必須呼叫 XStoreIsLicenseValid 來檢查授權是否有效。 XPackageMountWithUiAsync 在呼叫時會自動取得授權。 如果無法取得授權,套件就會掛接失敗。 此程式碼片段示範如何使用下列 API:

需求

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

概念文件

另請參閱

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
管理及授權可下載內容 (DLC)
Last modified on October 6, 2026