Compartir a través de

Función EnumTimeFormatsEx (winnls.h)

  • Artículo

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

Nota La aplicación debe llamar a esta función en preferencia a EnumTimeFormats si está diseñada para ejecutarse solo en Windows Vista y versiones posteriores.
 
Nota Esta función puede enumerar los datos que cambian entre versiones, por ejemplo, debido a una configuración regional personalizada. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.
 

Sintaxis

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

Parámetros

[in] lpTimeFmtEnumProcEx

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

[in, optional] lpLocaleName

Puntero a un nombre de configuración regional o uno de los siguientes valores predefinidos.

[in] dwFlags

Formato de hora. Establezca en 0 para usar el formato de tiempo largo del usuario actual o TIME_NOSECONDS (a partir de Windows 7) para usar el formato de tiempo corto.

[in] lParam

Parámetro proporcionado por la aplicación que se va a pasar a la función de devolución de llamada. Esto es especialmente útil para aplicaciones multiproceso.

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.

Comentarios

Esta función enumera los formatos de hora pasando punteros de cadena de formato de tiempo, de uno en uno, a la función de devolución de llamada definida por la aplicación especificada, junto con una constante definida por la aplicación que resulta útil para las aplicaciones multiproceso. 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.

A partir de Windows 8: si la aplicación pasa etiquetas de idioma a esta función desde el espacio de nombres Windows.Globalization, primero debe convertir las etiquetas llamando a ResolveLocaleName.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumTimeFormats

EnumTimeFormatsProcEx

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales