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

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

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

 

Синтаксис

BOOL EnumTimeFormatsA(
  [in] TIMEFMT_ENUMPROCA lpTimeFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Параметры

[in] lpTimeFmtEnumProc

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

[in] Locale

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

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED
• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

[in] dwFlags

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

Flag	Значение
0	Используйте длинный формат текущего пользователя.
TIME_NOSECONDS	Windows 7 и более поздние версии: используйте короткий формат времени текущего пользователя. Примечание Это значение не будет работать с версией ANSI этой функции EnumTimeFormatsA.
LOCAL_USE_CP_ACP	Указан в версии ANSI этой функции EnumTimeFormatsA (не рекомендуется) для использования системной кодовой страницы WINDOWS ANSI (ACP) по умолчанию вместо кодовой страницы языкового стандарта.

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

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

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

Комментарии

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

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

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

Примечание

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

Требования

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

См. также

EnumTimeFormatsEx

EnumTimeFormatsProc

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

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