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

Статья
11/20/2024

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

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

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

[in] Calendar

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

[in] CalType

Тип сведений о календаре. Дополнительные сведения см. в сведения о типе календаря. Для каждого вызова этой функции можно указать только один тип календаря, за исключением того, где указано.

Возвращаемое значение

Возвращает ненулевое значение в случае успешного выполнения или 0 в противном случае. Чтобы получить расширенные сведения об ошибке, приложение может вызывать GetLastError, что может возвращать один из следующих кодов ошибок:

ERROR_INVALID_FLAGS. Значения, предоставленные для флагов, недопустимы.
ERROR_INVALID_PARAMETER. Любое из значений параметров было недопустимым.

Замечания

См. примечания для EnumCalendarInfoEx.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll