EnumCalendarInfoExA 函数 (winnls.h)

枚举由标识符指定的区域设置的日历信息。

注意 仅在 Windows Vista 及更高版本上运行的任何应用程序都应优先使用此函数 EnumCalendarInfoExEx
 

语法

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

参数

[in] lpCalInfoEnumProcEx

指向应用程序定义的回调函数的指针。 有关详细信息,请参阅 EnumCalendarInfoProcEx

[in] Locale

区域设置标识符,指定要为其检索日历信息的区域设置。 可以使用 MAKELCID 宏创建标识符或使用以下预定义值之一。

Windows Vista 及更高版本: 还支持以下自定义区域设置标识符。

[in] Calendar

日历标识符,指定为其请求信息的日历。 请注意,此标识符可以ENUM_ALL_CALENDARS,以枚举与区域设置关联的所有日历。

[in] CalType

日历信息的类型。 有关详细信息,请参阅 日历类型信息。 每个对此函数的调用只能指定一个日历类型,除非有说明。

返回值

如果成功,则返回非零值,否则返回 0。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

  • ERROR_INVALID_FLAGS。 为标志提供的值无效。
  • ERROR_INVALID_PARAMETER。 任何参数值都无效。

言论

此函数根据 Calendar 参数的值,枚举指定区域设置或单个请求日历的所有适用日历的日历信息。 该函数通过调用指定的应用程序定义的回调函数来枚举日历信息。 它将回调函数传递给包含所请求日历信息的缓冲区的指针。 此过程一直持续到 EnumCalendarInfoEx 找到最后一个适用的日历或回调函数返回 FALSE

此函数可以从 自定义区域设置枚举数据。 数据不保证从计算机到计算机或应用程序运行之间相同。 如果应用程序必须持久保存或传输数据,请参阅 使用持久区域设置数据

当此函数的 ANSI 版本与仅 Unicode 区域设置标识符一起使用时,该函数可能会成功,因为操作系统使用系统代码页。 但是,系统代码页中未定义的字符在字符串中显示为问号(?)。

注意

winnls.h 标头将 EnumCalendarInfoEx 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winnls.h (包括 Windows.h)
Kernel32.lib
DLL Kernel32.dll

另请参阅

日历类型信息

EnumCalendarInfo

EnumCalendarInfoExEx

EnumCalendarInfoProcEx

EnumDateFormats

国家语言支持

国家语言支持函数