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

  • Статья

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

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

Синтаксис

BOOL EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

Параметры

[in] lpTimeFmtEnumProcEx

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

[in, optional] lpLocaleName

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

[in] dwFlags

Формат времени. Задайте значение 0, чтобы использовать длинный формат текущего пользователя, или TIME_NOSECONDS (начиная с Windows 7), чтобы использовать короткий формат времени.

[in] lParam

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

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

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

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

Комментарии

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

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

Требования

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

См. также

EnumTimeFormats

EnumTimeFormatsProcEx

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

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