XPackageMountWithUiAsync
以非同步方式掛接指定內容的安裝,並傳回其掛接控制代碼。 如果根據所有已登入使用者的家長監護設定,內容受到年齡限制,則會向使用者顯示家長同意 UI。語法
參數
packageIdentifier _In_z_類型:const char * 可唯一識別磁碟上已安裝套件的字串。 傳入從 XPackageEnumerationCallback 傳回之 XPackageDetails 結構中的 packageIdentifier 欄位。 如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 並授權。 async _Inout_
類型:XAsyncBlock * 用來監視非同步呼叫狀態的 XAsyncBlock。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
如果此 API 掛接的內容不適合所有已登入使用者的年齡,此 API 會向使用者顯示家長同意提示。 如果成人使用者在提示中核准家長同意,API 會嘗試掛接套件。 如果成人使用者在提示中拒絕家長同意,API 將無法掛接套件。 此 API 會自動呼叫 XStoreAcquireLicenseForPackageAsync / Result 和 XStoreIsLicenseValid。 如果 API 無法取得 DLC 的有效授權,掛接就會失敗。 在此程式碼範例中,如果內容受到年齡限制,遊戲會以黑白方式呈現 DLC。 當使用者選取要使用的 DLC 時,遊戲中的外部程式碼會呼叫MountDlc。
需求
標頭: XPackage.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XPackageMountWithUiResult XPackageXPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
如何為 PC 和 XBOX One 建立及使用可下載內容套件 (DLC)
