Skip to main content

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 XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
如何為 PC 和 XBOX One 建立及使用可下載內容套件 (DLC)
Last modified on October 6, 2026