Функция EnumCalendarInfoW (winnls.h)

Статья
03/04/2024

Перечисляет сведения календаря для указанного языкового стандарта.

Примечание Чтобы получить идентификатор календаря в дополнение к сведениям о календаре, приложение должно использовать функцию EnumCalendarInfoEx . Еще одна причина, по которой следует использовать эту функцию, заключается в том, что корпорация Майкрософт переходит на использование имен языковых стандартов вместо идентификаторов языкового стандарта для новых языковых стандартов в целях взаимодействия.

Примечание Любое приложение, которое будет выполняться только в Windows Vista и более поздних версий, должно использовать EnumCalendarInfoExExEx в предпочтительном для 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. Любое из значений параметров было недопустимым.

Заголовок winnls.h определяет EnumCalendarInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winnls.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll