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

  • Статья

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

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

Синтаксис

BOOL EnumDateFormatsExW(
  [in] DATEFMT_ENUMPROCEXW 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

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

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