Skip to main content

XPersistentLocalStorageMountForPackage

指定されたパッケージの永続ローカル ストレージ (PLS) を読み取り専用ディスクとしてマウントします。

Syntax

Parameters

packageIdentifier   _In_
型: char*
PLS が属するストア パッケージを一意に識別する文字列。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 mountHandle   _Out_writes_to_(pathSize,pathUsed)
型: XPackageMountHandle
PLS がマウントされたディスクのマウント ハンドル。

Return value

型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。指定されたタイトルの PLS が存在しないために関数が失敗した場合は、FILE_NOT_FOUND に設定されます。共有可能な永続ローカル ストレージを有効にしていないタイトルの PLS にアクセスしようとして関数が失敗した場合は、ACCESS_DENIED になります。

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
タイトルが共有可能な PLS をサポートするには、MicrosoftGame.config でその旨を宣言する必要があります。共有可能な永続ローカル ストレージの詳細については、ローカル ストレージ を参照してください。
タイトルが PLS を共有可能としてマークしている場合、ゲームを一時停止する前に PLS へのすべてのハンドルを閉じる必要があります。そうでない場合、ゲームの一時停止は失敗し、ゲームは終了します。
次のコード スニペットは、別のタイトルの共有可能な PLS にアクセスする例を示しています。

Requirements

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

Conceptual documentation

See also

XPersistentLocalStorage
新しい MicrosoftGame.config ファイルの使用方法
ローカル ストレージ
最終更新日 2026年8月24日