enumCalendarInfoW 函数 (winnls.h)

项目
03/04/2024

枚举指定区域设置的日历信息。

注意若要接收日历标识符以及日历信息，应用程序应使用 EnumCalendarInfoEx 函数。首选此函数的另一个原因是，出于互操作性的原因，Microsoft 正在迁移到使用区域设置名称而不是新区域设置的区域设置标识符。

注意将仅在 Windows Vista 及更高版本上运行的任何应用程序都应优先使用 EnumCalendarInfoExEx，而不是 EnumCalendarInfo。

语法

BOOL EnumCalendarInfoW(
  [in] CALINFO_ENUMPROCW lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

参数

[in] lpCalInfoEnumProc

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

[in] Locale

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

[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 [仅限桌面应用]
目标平台	Windows
标头	winnls.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll