EnumCalendarInfo函数枚举指定区域设置的日历信息。【CalType】参数指定要枚举的日历信息的类型。该函数将根据【日历】参数的值返回指定的日历信息,用于该区域设置或单个请求的日历的所有适用日历。
EnumCalendarInfo函数通过调用应用程序定义的回调函数枚举日历信息。它将回调函数传递给包含请求的日历信息的字符串缓冲区的指针。这将持续到最后一个适用的日历被找到或回调函数返回FALSE。
BOOL EnumCalendarInfo(
CALINFO_ENUMPROC 【lpCalInfoEnumProc】, | //指向枚举回调函数的指针 |
LCID 【语言环境】, | //其日历信息感兴趣的区域设置 |
CALID 【日历】, | //日历的信息是感兴趣的 |
CALTYPE 【CalType】 | //感兴趣的日历信息类型 |
); |
参数
【lpCalInfoEnumProc】
指向应用程序定义的回调函数。有关详细信息,请参阅EnumCalendarInfoProc回调函数。
【语言环境】
指定检索日历信息的区域设置。此参数可以是由MAKELCID宏或以下预定义值之一创建的区域设置标识符:
LOCALE_SYSTEM_DEFAULT | 默认系统区域设置。 |
LOCALE_USER_DEFAULT | 默认用户区域设置。 |
【日历】
指定请求信息的日历。定义了以下值:
值 | 含义 |
ENUM_ALL_CALENDARS | 枚举【语言环境】指定的区域设置的所有适用日历。 |
1 | 格里高利(本地化) |
2 | 格里高利(总是英文字符串) |
3 | 日本时代 |
4 | 中华民国年 |
5 | 唐人时代(韩国) |
【CalType】
指示要返回的日历信息的类型。请注意,每个调用此函数只能指定一个CALTYPE值。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
ERROR_BADDB
ERROR_INVALID_FLAGS
ERROR_INVALID_PARAMETER
也可以看看