GetUILanguageInfo

インストールされた UI 言語に関するさまざまな情報を取得する。

GetUILanguageInfo dwFlags, pwmszLanguage, pwszFallbackLanguages, pcchFallbackLanguages, pAttributes

dwFlags : [int] 指定した言語の形式を定義するフラグ。フラグは相互排他的で、既定は MUI_LANGUAGE_NAME である。
pwmszLanguage : [int] 関数が情報を取得する言語へのポインタ。このパラメータは、フラグ設定に応じて、言語識別子または言語名の順序付けられた null 区切りリストを示す。このパラメータの使用については備考セクションを参照。
pwszFallbackLanguages : [int] dwFlags の設定で定義された形式で、この関数が順序付けされた null 区切りのフォールバック言語リストを取得するバッファへのポインタ。このリストは 2 つの null 文字で終わる。あるいは、このパラメータが NULL に設定され、pcchLanguagesBuffer が 0 に設定されている場合、関数は必要な言語バッファのサイズを pcchLanguagesBuffer に取得する。必要なサイズには 2 つの null 文字が含まれる。
pcchFallbackLanguages : [var] pwszFallbackLanguages が示す言語バッファのサイズ（文字数）へのポインタ。関数から正常に戻ったとき、このパラメータには取得された言語バッファのサイズが含まれる。あるいは、このパラメータが 0 に設定され、pwszLanguagesBuffer が NULL に設定されている場合、関数は必要な言語バッファのサイズを pcchLanguagesBuffer に取得する。
pAttributes : [var] 入力言語リストの属性を示すフラグへのポインタ。関数は常に最後にリストされている言語を特徴付けるフラグを取得する。

(プラグイン / モジュール : kernel32.dll)

解説

インストールされた UI 言語に関するさまざまな情報を取得する。

[戻り値]
成功した場合は TRUE、それ以外の場合は FALSE を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶ。これは以下のエラーコードを返すことがある。
（以下省略）

[備考]
MUI_LANGUAGE_NAME は、定義済みロケールに対応せず代わりに補助ロケールに対応する LIP
言語をより適切に処理できるため、MUI_LANGUAGE_ID よりも推奨される。定義済みロケールに対応する LIP 言語は LIP
でない言語と同じように処理される。MUI_LANGUAGE_ID フラグが指定されている場合、提供される言語文字列は先頭の 0x
を含まない 16 進数の言語識別子を使用し、長さは 4 文字でなければならない。たとえば en-US は "0409" として、en は
"0009" として渡されるべきである。返される言語文字列も同じ形式となる。MUI_LANGUAGE_ID が指定され、ユーザーの優先
UI 言語リストにそのような言語がある場合、リスト内にそのような言語は 1 つしか含めない。その言語は
LOCALE_CUSTOM_UI_DEFAULT の 16 進数値に対応する "1400" として pwmszLanguage
に指定できる。MUI_LANGUAGE_ID を使用して他のそのような言語を指定することはできない。pwmszLanguage
が示す文字列内で LOCALE_CUSTOM_UNSPECIFIED の 16 進数値に対応する "1000"
を使用すると、ERROR_INVALID_PARAMETER
コードになる。部分的にローカライズされた言語が部分的にローカライズされたフォールバック言語を持つことがあり、完全な情報を取得するには
GetUILanguageInfo を繰り返し呼び出す必要がある。3
つのフォールバック言語の選択肢を提供する部分的にローカライズされた言語 Lang1 のケースを考える。Lang3
フォールバック言語は部分的にローカライズされており、2
つのフォールバック言語の選択肢を提供する。依存関係は次のとおりで、既定のフォールバックが最初にリストされている。
（以下省略）

情報