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

  • Статья

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

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

Синтаксис

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Параметры

[in] lpDateFmtEnumProcEx

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

[in] Locale

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

Windows Vista и более поздних версий: Также поддерживаются следующие пользовательские идентификаторы языкового стандарта.

[in] dwFlags

Флаг, указывающий форматы дат. Подробные определения см. в параметре dwFlagsобъекта EnumDateFormatsExEx.

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

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

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

Комментарии

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

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

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

Если версия ANSI этой функции используется с идентификатором языкового стандарта только в Юникоде, функция может быть успешной, так как операционная система использует системную кодовую страницу. Однако символы, неопределенные на системной кодовой странице, отображаются в строке как вопросительный знак (?).

Приложение должно использовать EnumDateFormatsEx (вместо EnumDateFormats) для перечисления форматов дат для языковых стандартов с альтернативными календарями.

Примечание

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

Требования

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

См. также

EnumDateFormats

EnumDateFormatsExEx

EnumDateFormatsProcEx

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

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