GetCurrencyFormatEx

名前で指定したロケール用に数値文字列を通貨文字列として整形する。注意: アプリケーションが Windows Vista 以降でのみ動作するように設計されている場合、GetCurrencyFormat よりこの関数を優先して呼び出すべきである。注意: この関数はリリース間で変化し得るデータ（たとえばカスタムロケール由来のもの）を整形することがある。アプリケーションがデータを永続化または送信する必要がある場合は Using Persistent Locale Data を参照。

GetCurrencyFormatEx lpLocaleName, dwFlags, lpValue, lpFormat, lpCurrencyStr, cchCurrency

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

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

解説

名前で指定したロケール用に数値文字列を通貨文字列として整形する。注意: アプリケーションが Windows Vista
以降でのみ動作するように設計されている場合、GetCurrencyFormat よりこの関数を優先して呼び出すべきである。注意:
この関数はリリース間で変化し得るデータ（たとえばカスタムロケール由来のもの）を整形することがある。アプリケーションがデータを永続化または送信する必要がある場合は
Using Persistent Locale Data を参照。

[戻り値]
成功した場合、lpCurrencyStr が示すバッファに取得された文字数を返す。cchCurrency パラメータが 0
の場合、関数は終端 NULL 文字を含む整形済み通貨文字列を保持するのに必要なバッファサイズを返す。成功しなかった場合は 0
を返す。拡張エラー情報を取得するには GetLastError を呼び出すことができ、次のいずれかのエラーコードが返ることがある。
（以下省略）

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

情報