Función EnumTimeFormatsA (winnls.h)

Enumera los formatos de hora que están disponibles para una configuración regional especificada por identificador.

Nota Por motivos de interoperabilidad, la aplicación debe preferir la función EnumTimeFormatsEx para EnumTimeFormats porque Microsoft está migrando hacia el uso de nombres de configuración regional en lugar de identificadores de configuración regional para nuevas configuraciones regionales. Cualquier aplicación que se ejecute solo en Windows Vista y versiones posteriores debe usar EnumTimeFormatsEx.

 

Sintaxis

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

Parámetros

[in] lpTimeFmtEnumProc

Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumTimeFormatsProc.

[in] Locale

identificador de configuración regional que especifica la configuración regional para la que se va a recuperar la información de formato de hora. Puede usar la macro MAKELCID para crear un identificador de configuración regional o usar uno de los siguientes valores predefinidos.

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

[in] dwFlags

Formato de hora. Este parámetro puede especificar una combinación de cualquiera de los valores siguientes.

Bandera	Significado
0	Use el formato de tiempo largo del usuario actual.
TIME_NOSECONDS	Windows 7 y versiones posteriores: use el formato de tiempo corto del usuario actual. Nota Este valor no funcionará con la versión ANSI de esta función, EnumTimeFormatsA.
LOCAL_USE_CP_ACP	Se especifica con la versión ANSI de esta función, enumTimeFormatsA (no recomendado), para usar la página de códigos ANSI (ACP) predeterminada del sistema en lugar de la página de códigos de configuración regional.

Valor devuelto

Devuelve un valor distinto de cero si se ejecuta correctamente o 0 de lo contrario. Para obtener información de error extendida, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

• ERROR_INVALID_FLAGS. Los valores proporcionados para las marcas no eran válidos.
• ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Observaciones

La función enumera los formatos de hora pasando un puntero a un búfer que contiene un formato de hora a una función de devolución de llamada definida por la aplicación. El primer valor de la enumeración siempre es el valor predeterminado del usuario (invalidación). La función continúa la enumeración hasta que se encuentra el último formato de hora o la función de devolución de llamada devuelve FALSE.

Esta función puede enumerar datos de configuraciones regionales personalizadas. No se garantiza que los datos sean los mismos desde el equipo al equipo o entre ejecuciones de una aplicación. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

Cuando se usa la versión ANSI de esta función con un identificador de configuración regional de solo Unicode, la llamada puede realizarse correctamente porque el sistema usa la página de códigos del sistema. Sin embargo, los caracteres que no están definidos en la página de códigos del sistema aparecen en la cadena como un signo de interrogación ("?"). Tenga en cuenta que los nuevos valores de dwFlags introducidos en el futuro no funcionarán con la versión ANSI.

Nota

El encabezado winnls.h define EnumTimeFormats como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnls.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

EnumTimeFormatsEx

EnumTimeFormatsProc

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales