GetNumberFormatEx

数値文字列を、名前で指定したロケール用にカスタマイズした数値文字列としてフォーマットする。注意 Windows Vista 以降のみで動作するように設計されているアプリケーションは、GetNumberFormat よりもこの関数を優先して呼び出すべきである。注意 この関数は、カスタムロケールなどの理由でリリース間で変化するデータをフォーマットできる。アプリケーションがデータを永続化または送信する必要がある場合は、Using Persistent Locale Data を参照。

GetNumberFormatEx lpLocaleName, dwFlags, lpValue, lpFormat, lpNumberStr, cchNumber

lpLocaleName : [wstr] ロケール名へのポインタ、または以下の定義済み値のいずれか。
dwFlags : [int] 関数の動作を制御するフラグ。lpFormat が NULL に設定されていない場合、アプリケーションはこのパラメータを 0 に設定する必要がある。この場合、関数はロケールの既定の数値形式に対するユーザー上書きを使用して文字列をフォーマットする。lpFormat が NULL に設定されている場合、アプリケーションは LOCALE_NOUSEROVERRIDE を指定して、指定したロケールに対するシステム既定の数値形式で文字列をフォーマットできる。注意 LOCALE_NOUSEROVERRIDE の使用はユーザー設定を無効にするため、強く非推奨である。
lpValue : [wstr] フォーマット対象の数値文字列を含む null 終端文字列へのポインタ。この文字列は以下の文字のみを含むことができる。それ以外の文字はすべて無効である。lpValue が示す文字列がこれらの規則から逸脱している場合、関数はエラーを返す。
lpFormat : [var] 数値書式情報を含む NUMBERFMT 構造体へのポインタ。すべてのメンバが適切な値に設定されている必要がある。アプリケーションがこのパラメータを NULL に設定しない場合、関数は構造体で指定されていない書式情報（たとえば負号のロケール文字列値）にのみロケールを使用する。
lpNumberStr : [wstr] この関数がフォーマット済み数値文字列を取得するバッファへのポインタ。あるいは、cchNumber が 0 に設定されている場合、このパラメータは NULL を含む。その場合、関数は数値文字列バッファに必要なサイズを返す。
cchNumber : [int] lpNumberStr が示す数値文字列バッファのサイズ（文字数）。アプリケーションはこのパラメータを 0 に設定することもできる。その場合、関数は数値文字列バッファに必要なサイズを返し、lpNumberStr パラメータを使用しない。

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

解説

数値文字列を、名前で指定したロケール用にカスタマイズした数値文字列としてフォーマットする。注意 Windows Vista
以降のみで動作するように設計されているアプリケーションは、GetNumberFormat よりもこの関数を優先して呼び出すべきである。注意
この関数は、カスタムロケールなどの理由でリリース間で変化するデータをフォーマットできる。アプリケーションがデータを永続化または送信する必要がある場合は、Using
Persistent Locale Data を参照。

[戻り値]
成功した場合、lpNumberStr が示すバッファに取得された文字数を返す。cchNumber パラメータが 0
に設定されている場合、関数はフォーマット済み数値文字列を保持するために必要な文字数（終端 null
文字を含む）を返す。成功しなかった場合、関数は 0 を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶ。これは以下のいずれかのエラーコードを返す。
（以下省略）

[備考]
Windows 8 以降: アプリケーションが Windows.Globalization 名前空間から言語タグをこの関数に渡す場合、まず
ResolveLocaleName を呼び出してタグを変換する必要がある。

情報