Skip to main content

XPackageMountWithUiAsync

指定されたコンテンツのインストールを非同期でマウントし、そのマウント ハンドルを返します。 サインインしているすべてのユーザーのペアレンタル設定に基づいてコンテンツが年齢制限されている場合、ユーザーのペアレンタル同意 UI を表示します。

Syntax

Parameters

packageIdentifier  _In_z_
型: const char *
ディスク上のインストール済みパッケージを一意に識別する文字列。 XPackageEnumerationCallback から返される XPackageDetails 構造体の packageIdentifier フィールドを渡します。 パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 async  _Inout_
型: XAsyncBlock *
非同期呼び出しの状態を監視するための XAsyncBlock

Return value

型: HRESULT HRESULT の成功またはエラー コード。

Remarks

この API は、API がサインインしているすべてのユーザーの年齢に適さないコンテンツをマウントする場合、ユーザーにペアレンタル同意プロンプトを表示します。 プロンプトで大人のユーザーがペアレンタル同意を承認した場合、API はパッケージのマウントを試みます。 プロンプトで大人のユーザーがペアレンタル同意を拒否した場合、API はパッケージのマウントに失敗します。 この API は、XStoreAcquireLicenseForPackageAsync / Result および XStoreIsLicenseValid を自動的に呼び出します。 API が DLC の有効なライセンスを取得できない場合、マウントは失敗します。 このコード例では、コンテンツが年齢制限されている場合、ゲームは DLC を白黒でレンダリングします。 ユーザーが使用する DLC の一部を選択したとき、ゲーム内の外部コードは MountDlc を呼び出します。

Requirements

ヘッダー: XPackage.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、および XBOX Series 本体

Conceptual documentation

See also

XPackageMountWithUiResult XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
PC および XBOX One 用のダウンロード可能コンテンツ パッケージ (DLC) を作成および使用する方法
最終更新日 2026年8月24日