EnumCalendarInfoA 函数 (winnls.h)
枚举指定区域设置的日历信息。
注释 除了日历信息之外,应用程序还应使用 EnumCalendarInfoEx 函数来接收日历标识符。 首选此函数的另一个原因是,出于互操作性原因,Microsoft迁移到使用区域设置名称而不是区域设置标识符。
注意 任何仅在 Windows Vista 及更高版本上运行的应用程序都应使用 EnumCalendarInfoExEx,而不是 EnumCalendarInfo。
语法
BOOL EnumCalendarInfoA(
[in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
[in] LCID Locale,
[in] CALID Calendar,
[in] CALTYPE CalType
);
参数
[in] lpCalInfoEnumProc
指向应用程序定义的回调函数的指针。 有关详细信息,请参阅 EnumCalendarInfoProc。
[in] Locale
区域设置标识符,指定要为其检索日历信息的区域设置。 可以使用 MAKELCID 宏创建区域设置标识符或使用以下预定义值之一。
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] Calendar
日历标识符,指定为其请求信息的日历。 请注意,此标识符可以ENUM_ALL_CALENDARS,以枚举与区域设置关联的所有日历。
[in] CalType
日历信息的类型。 有关详细信息,请参阅 日历类型信息。 每个对此函数的调用只能指定一个日历类型,除非有说明。
返回值
如果成功,则返回非零值,否则返回 0。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:
- ERROR_INVALID_FLAGS。 为标志提供的值无效。
- ERROR_INVALID_PARAMETER。 任何参数值都无效。
言论
请参阅有关 EnumCalendarInfoEx的备注。
注意
winnls.h 标头将 EnumCalendarInfo 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winnls.h (包括 Windows.h) |
库 | Kernel32.lib |
DLL | Kernel32.dll |