XPackageGetUserLocale
現在のユーザー ロケールを取得します。Syntax
Parameters
localeSize _In_型: size_t 成功時、locale 内の文字列のサイズ。 locale _Out_writes_(localeSize)
型: char* 成功時、ユーザー ロケールを含みます。
Return value
型: HRESULT HRESULT の成功またはエラー コード。Remarks
この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
locale にユーザー ロケールは返されません。パッケージ ロケールがインストールされたユーザー ロケールと一致する場合、関数は成功し、そのユーザー ロケールを locale に返します。パッケージ ロケールがインストールされたユーザー ロケールと正確に一致しない場合、関数は最も近く一致するインストール済みユーザー ロケールを見つけようとします。関数が近い一致を見つけられない場合、エラーが発生します。それ以外の場合、関数は成功し、最も近く一致するインストール済みユーザー ロケールが locale に返されます。
インテリジェント デリバリーを使用してゲーム用にインストールする言語を制御している場合、ユーザーが本体に設定したロケールに、現在インストールされていないチャンクが含まれている可能性があります。これにより、ゲームは必要なチャンクがインストールされていることを常に確認し、インストールされていない場合は別の言語にフォールバックする必要があります。この手順には、ロケールとそれらが最も近い言語にフォールバックする方法についてのかなりの知識が必要です。この関数は、独自のロケール分析とフォールバック手順を実装する必要なしに、現在のユーザー ロケール、または最も近い一致するフォールバックを取得する方法を提供します。
次のコード サンプルは、この関数の使用方法を示しています。
Requirements
ヘッダー: XPackage.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XPackageストリーミング インストールとインテリジェント デリバリー