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

Статья
03/04/2024

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

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

Примечание Эта функция может перечислять данные, которые изменяются между выпусками, например из-за пользовательского языкового стандарта. Если приложение должно сохранять или передавать данные, см. статью Использование данных сохраняемого языкового стандарта.

Синтаксис

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Параметры

[in] pCalInfoEnumProcExEx

Указатель на функцию обратного вызова, определяемую приложением. Дополнительные сведения см. в разделе EnumCalendarInfoProcExEx.

[in, optional] lpLocaleName

Указатель на имя языкового стандарта или одно из следующих предопределенных значений.

[in] Calendar

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

[in, optional] lpReserved

Защищены; значение должно иметь значение NULL.

[in] CalType

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

[in] lParam

Предоставленный приложением параметр для передачи функции обратного вызова. Это значение особенно полезно для многопоточных приложений.

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

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

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

Эта функция перечисляет сведения календаря для всех применимых календарей для указанного языкового стандарта или для одного запрошенного календаря в зависимости от значения параметра Calendar . Функция перечисляет сведения календаря, вызывая указанную функцию обратного вызова, определяемую приложением. Функция обратного вызова передает указатель на буфер, содержащий запрошенные сведения календаря, идентификатор календаря и определяемый приложением параметр, который полезен для многопоточных приложений. Этот процесс продолжается до тех пор , пока EnumCalendarInfoExEx не найдет последний применимый календарь или функция обратного вызова не вернет ЗНАЧЕНИЕ FALSE.

Начиная с Windows 8. Если приложение передает языковые теги в эту функцию из пространства имен Windows.Globalization, оно должно сначала преобразовать теги, вызвав ResolveLocaleName.

Требования

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