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

Статья
08/27/2023

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

Примечание Любое приложение, которое выполняется только в 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 этой функции используется с идентификатором языкового стандарта только в Юникоде, функция может завершиться успешно, так как операционная система использует системную кодовую страницу. Однако символы, которые не определены на системной кодовой странице, отображаются в строке как вопросительный знак (?).

Примечание

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

Требования


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