EnumCalendarInfoEx

原文链接 -> 传送门

函数功能：

EnumCalendarInfoEx 函数用于通过标识符枚举指定区域设置的日历信息。

注意：任何运行在 Windows Vista 和之后版本上的应用程序应该使用 EnumCalendarInfoExEx 函数来代替这个函数。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL EnumCalendarInfoEx(
  _In_ CALINFO_ENUMPROCEX pCalInfoEnumProcEx,
  _In_ LCID               Locale,
  _In_ CALID              Calendar,
  _In_ CALTYPE            CalType
);

参数解析：

返回值：

若函数成功，返回是非 0；否则返回值为 0。

为了获得更多的错误信息，程序可以调用 GetLastError 函数，其可以返回下列错误代码：

• ERROR_INVALID_FLAGS：提供的标记值是无效的
• ERROR_INVALID_PARAMETER：任何参数值是无效的

备注：

1. 此函数为指定的区域设置，枚举所有适用的日历的日历信息，或为一个单一的请求日历，依赖于 Calendar 参数的值。通过调用指定的应用程序定义的回调函数来枚举日历信息。它将传递给回调函数一个指针，指向包含请求的日历信息的缓冲区。此过程继续直到 EnumCalendarInfoEx 发现最后适用日历或回调函数返回 FALSE。

2. 此函数可以枚举自定义区域设置的数据。从计算机到计算机或运行的应用程序之间，数据不能保证相同。如果您的应用程序必须持续或传输数据，请参见 Using Persistent Locale Data。

3. 当此函数的 ANSI 版本通过仅 Unicode 的区域设置标识符来使用时，函数可以成功，因为操作系统使用系统代码页。但是，在系统代码页中未定义的字符在字符串中显示为问号（？）。


需求：