メインコンテンツへスキップ

XPersistentLocalStorageGetPathSize

永続ローカル ストレージ (PLS) へのパスの長さを文字数で返します。

Syntax

Parameters

pathSize   _Out_
型: size_t*
PLS パスの長さ (文字数)。

Return value

型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。

Remarks

この関数はタイム センシティブなスレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブなスレッド を参照してください。
この関数の戻り値は、XPersistentLocalStorageGetPath 関数の pathSize パラメーターに使用され、デバイス上のゲーム固有の PLS パスを返します。PLS の詳細については、ローカル ストレージ を参照してください。 XPersistentLocalStorageGetPath 関数を呼び出すときは、この関数の pathSize パラメーターに返された値以上の文字数を XPersistentLocalStorageGetPath の path パラメーターに割り当ててください。そうしないとエラーが発生します。 次の例は、XPersistentLocalStorageGetPathSize および XPersistentLocalStorageGetPath 関数を使用してゲームの PLS パスを取得する方法を示しています。

Requirements

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

Conceptual documentation

See also

XPersistentLocalStorageGetPath
XPersistentLocalStorage
新しい MicrosoftGame.config ファイルの使用方法
最終更新日 2026年10月19日