GetCurrencyFormatA 関数 (winnls.h)
識別子で指定されたロケールの通貨文字列として数値文字列を書式設定します。
構文
int GetCurrencyFormatA(
[in] LCID Locale,
[in] DWORD dwFlags,
[in] LPCSTR lpValue,
[in, optional] const CURRENCYFMTA *lpFormat,
[out, optional] LPSTR lpCurrencyStr,
[in] int cchCurrency
);
パラメーター
[in] Locale
この関数が通貨文字列を書式設定するロケールを指定するロケール識別子。 MAKELCID マクロを使用してロケール識別子を作成するか、次のいずれかの定義済み値を使用できます。
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] dwFlags
通貨形式を制御するフラグ。 lpFormat が NULLに設定されていない場合
[in] lpValue
詳細については、getCurrencyFormatExの
[in, optional] lpFormat
通貨書式情報を含む CURRENCYFMT 構造体へのポインター。 構造体のすべてのメンバーに適切な値を含める必要があります。 関数が指定されたロケールの通貨形式を使用する場合、アプリケーションはこのパラメーターを NULL を
[out, optional] lpCurrencyStr
この関数が書式設定された通貨文字列を取得するバッファーへのポインター。
[in] cchCurrency
lpCurrencyStr バッファーのサイズ (文字数)。 関数が書式設定された通貨文字列を保持するために必要なバッファーのサイズを返す場合、アプリケーションはこのパラメーターを 0 に設定します。 この場合、lpCurrencyStr パラメーターは使用されません。
戻り値
成功した場合に lpCurrencyStr
成功しなかった場合、関数は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError
- ERROR_INSUFFICIENT_BUFFER。 指定されたバッファー サイズが十分な大きさではなかったか、NULL
正しく設定されていません。 - ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効でした。
備考
この関数は、カスタム ロケールからデータ
この関数の ANSI バージョンを Unicode のみのロケール識別子と共に使用すると、オペレーティング システムがシステム コード ページを使用するため、呼び出しが成功する可能性があります。 ただし、システム コード ページで未定義の文字は、文字列に疑問符 (?) として表示されます。
手記
winnls.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetCurrencyFormat を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winnls.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |
関連項目
CURRENCYFMT を
GetCurrencyFormatEx を
GetNumberFormat の