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

Статья
03/13/2024

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

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

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

Синтаксис

BOOL EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Параметры

[in] lpDateFmtEnumProcExEx

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

[in, optional] lpLocaleName

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

[in] dwFlags

Флаг, указывающий форматы дат. Приложение может предоставить одно из следующих значений или константу LOCALE_USE_CP_ACP .

Значение	Значение
DATE_SHORTDATE	Используйте короткие форматы даты. Это значение нельзя использовать с другими значениями флагов.
DATE_LONGDATE	Используйте длинные форматы даты. Это значение нельзя использовать с другими значениями флагов.
DATE_YEARMONTH	Используйте форматы год/месяц. Это значение нельзя использовать с другими значениями флагов.
DATE_MONTHDAY	Используйте форматы месяцев и дней. Это значение нельзя использовать с другими значениями флагов.

[in] lParam

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

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

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

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

Примечание Этот API обновляется для поддержки изменения японской эры за май 2019 г. Если приложение поддерживает японский календарь, убедитесь, что он правильно обрабатывает новую эру. Дополнительные сведения см. в статье Подготовка приложения к изменениям японской эпохи .

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

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

Требования

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

См. также

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExEx

Поддержка национальных языков

Функции поддержки национальных языков