getCurrencyFormatEx 函数 (winnls.h)

项目
08/27/2023

将数字字符串的格式设置为由 name 指定的区域设置的货币字符串。

注意如果设计为仅在 Windows Vista 及更高版本上运行，则应用程序应优先调用 GetCurrencyFormat 。

注意此函数可以设置版本之间更改的数据的格式，例如，由于自定义区域设置。如果应用程序必须保留或传输数据，请参阅使用持久区域设置数据。

语法

int GetCurrencyFormatEx(
  [in, optional]  LPCWSTR            lpLocaleName,
  [in]            DWORD              dwFlags,
  [in]            LPCWSTR            lpValue,
  [in, optional]  const CURRENCYFMTW *lpFormat,
  [out, optional] LPWSTR             lpCurrencyStr,
  [in]            int                cchCurrency
);

参数

[in, optional] lpLocaleName

指向区域设置名称或以下预定义值之一的指针。

[in] dwFlags

控制函数操作的标志。如果 lpFormat 未设置为 NULL，则应用程序必须将此参数设置为 0。在这种情况下，函数使用用户替代将字符串的格式设置为区域设置的默认货币格式。如果 lpFormat 设置为 NULL，则应用程序可以指定 LOCALE_NOUSEROVERRIDE ，以使用指定区域设置的系统默认货币格式设置字符串的格式。

谨慎强烈建议不要使用 LOCALE_NOUSEROVERRIDE ，因为它会禁用用户首选项。

[in] lpValue

指向以 null 结尾的字符串的指针，该字符串包含要设置格式的数字字符串。此字符串只能包含以下字符。所有其他字符都无效。如果字符串偏离这些规则，函数将返回错误。

字符“0”到“9”
如果数字是浮点值，则一个小数点 (点)
如果数字为负值，则为第一个字符位置的减号

[in, optional] lpFormat

指向包含货币格式信息的 CURRENCYFMT 结构的指针。结构的所有成员都必须包含适当的值。如果函数要使用指定区域设置的货币格式，则应用程序可以将此参数设置为 NULL 。如果此参数未设置为 NULL，则该函数仅将指定的区域设置用于 未在 CURRENCYFMT 结构中指定的格式设置信息，例如，区域设置使用的负号的字符串值。

[out, optional] lpCurrencyStr

指向缓冲区的指针，此函数在其中检索格式化货币字符串。

[in] cchCurrency

lpCurrencyStr 缓冲区的大小（以字符为单位）。应用程序可以将此参数设置为 0，以返回保存格式化货币字符串所需的缓冲区大小。在这种情况下，不使用 lpCurrencyStr 指示的缓冲区。

返回值

如果成功，则返回 lpCurrencyStr 指示的缓冲区中检索到的字符数。如果 cchCurrency 参数为 0，则该函数将返回保存格式化货币字符串所需的缓冲区大小，包括终止 null 字符。

如果函数不成功，则返回 0。若要获取扩展的错误信息，应用程序可以调用 GetLastError，这会返回以下错误代码之一：

ERROR_INSUFFICIENT_BUFFER。提供的缓冲区大小不够大，或者错误地设置为 NULL。
ERROR_INVALID_FLAGS。为标志提供的值无效。
ERROR_INVALID_PARAMETER。任何参数值都无效。

注解

从 Windows 8 开始： 如果你的应用将语言标记从 Windows.Globalization 命名空间传递到此函数，它必须首先通过调用 ResolveLocaleName 来转换标记。

要求


最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	winnls.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

另请参阅

getCurrencyFormatEx 函数 (winnls.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源