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

Статья
11/20/2024

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

Примечание Любое приложение, которое работает только в 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll