GetLocaleInfoW

識別子で指定したロケールに関する情報を取得する。(Unicode)

GetLocaleInfoW Locale, LCType, lpLCData, cchData

Locale : [int] 情報を取得するロケール識別子。MAKELCID マクロでロケール識別子を作成するか、以下の定義済み値のいずれかを使用できる。
LCType : [int] 取得するロケール情報。詳細な定義は GetLocaleInfoEx の LCType パラメータを参照。注: GetLocaleInfo では LOCALE_USE_CP_ACP の値は ANSI 版でのみ意味を持つ。
lpLCData : [wstr] 本関数が要求されたロケール情報を取得するバッファへのポインタ。cchData が 0 の場合、このポインタは使用されない。詳細は注釈を参照。
cchData : [int] lpLCData が示すデータバッファのサイズ（TCHAR 単位）。あるいは、アプリケーションは本パラメータを 0 に設定できる。この場合、関数は lpLCData パラメータを使用せず、終端 null 文字を含む必要なバッファサイズを返す。

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

解説

識別子で指定したロケールに関する情報を取得する。(Unicode)

[戻り値]
成功し cchData が 0 以外の値の場合、ロケールデータバッファに取得された文字数を返す。関数が成功し、cchData が 0
以外で LOCALE_RETURN_NUMBER が指定されている場合、戻り値はデータバッファに取得された整数のサイズ、すなわち
Unicode 版の関数では 2、ANSI 版では 4 となる。関数が成功し cchData の値が 0
の場合、戻り値はロケールデータバッファに必要なサイズで、null 文字を含めた文字数である。関数が成功しなかった場合は 0
を返す。拡張エラー情報を取得するには GetLastError を呼ぶ。次のエラーコードのいずれかが返ることがある。
（以下省略）

[備考]
本関数の動作については GetLocaleInfoEx の注釈を参照。注: LCType を LOCALE_FONTSIGNATURE
と指定した場合でも、cchData と関数の戻り値は依然として TCHAR 数である。カウントは ANSI 版と Unicode
版で異なる。アプリケーションが LCType に LOCALE_FONTSIGNATURE を指定して汎用版の GetLocaleInfo
を呼ぶ場合、cchData は安全に sizeof(LOCALESIGNATURE) / sizeof(TCHAR)
と指定できる。次の例は、テキスト以外の値に対するバッファサイズを正しく扱う例である。
（以下省略）

情報