EnumDateFormatsExExEx 函数 (winnls.h)
枚举可用于名称指定的区域设置的长日期、短日期或年/月格式。
注意如果设计为仅在 Windows Vista 及更高版本上运行，应用程序应优先调用此函数，而不是 EnumDateFormats 或 EnumDateFormatsEx。
注意 此函数可以枚举在发布之间发生更改的数据，例如，由于自定义区域设置。 如果应用程序必须保留或传输数据，请参阅 使用永久性区域设置数据。
语法
BOOL EnumDateFormatsExEx(
[in] DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
[in, optional] LPCWSTR lpLocaleName,
[in] DWORD dwFlags,
[in] LPARAM lParam
);
参数
[in] lpDateFmtEnumProcExEx
指向应用程序定义的回调函数的指针。 有关详细信息，请参阅 EnumDateFormatsProcExExEx。
[in, optional] lpLocaleName
指向 区域设置名称或以下预定义值之一的指针。
[in] dwFlags
指定日期格式的标志。 应用程序可以提供以下值之一或 LOCALE_USE_CP_ACP 常量。
| 值 | 含义 |
|---|---|
|
使用短日期格式。 此值不能与任何其他标志值一起使用。 |
|
使用长日期格式。 此值不能与任何其他标志值一起使用。 |
|
使用年/月格式。 此值不能与任何其他标志值一起使用。 |
|
使用月/日格式。 此值不能与任何其他标志值一起使用。 |
[in] lParam
要传递给回调函数的应用程序提供的参数。 此值对于多线程应用程序特别有用。
返回值
如果成功，则返回非零值，否则返回 0。 若要获取扩展错误信息，应用程序可以调用 GetLastError，这会返回以下错误代码之一：
- ERROR_BADDB。 函数无法访问数据。 这种情况通常不应发生，通常表示安装错误、磁盘问题或类似问题。
- ERROR_INVALID_FLAGS。 为标志提供的值无效。
- ERROR_INVALID_PARAMETER。 任何参数值都无效。
注解
注意 此 API 正在更新，以支持 2019 年 5 月日本时代更改。 如果应用程序支持日语日历，则应验证它是否正确处理了新纪元。 有关详细信息 ，请参阅为日本时代更改准备应用程序 。
从Windows 8开始：如果你的应用将语言标记从 Windows.Globalization 命名空间传递到此函数，它必须首先通过调用 ResolveLocaleName 来转换标记。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | winnls.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |