Fonction EnumTimeFormatsEx (winnls.h)

  • Article

Énumère les formats d’heure disponibles pour un paramètre régional spécifié par nom.

Note L’application doit appeler cette fonction de préférence pour EnumTimeFormats si elle est conçue pour s’exécuter uniquement sur Windows Vista et versions ultérieures.
 
Note Cette fonction peut énumérer les données qui changent d’une version à l’autre, par exemple en raison d’un paramètre régional personnalisé. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.
 

Syntaxe

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

Paramètres

[in] lpTimeFmtEnumProcEx

Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumTimeFormatsProcEx.

[in, optional] lpLocaleName

Pointeur vers un nom de paramètres régionaux ou l’une des valeurs prédéfinies suivantes.

[in] dwFlags

Format d’heure. Définissez sur 0 pour utiliser le format de temps long de l’utilisateur actuel ou TIME_NOSECONDS (à partir de Windows 7) pour utiliser le format de temps court.

[in] lParam

Paramètre fourni par l’application à passer à la fonction de rappel. Cela est particulièrement utile pour les applications multithread.

Valeur retournée

Retourne une valeur différente de zéro en cas de réussite, ou 0 dans le cas contraire. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

  • ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
  • ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Remarques

Cette fonction énumère les formats de temps en passant des pointeurs de chaîne de format de temps, un par un, à la fonction de rappel définie par l’application spécifiée, ainsi qu’une constante définie par l’application qui est utile pour les applications multithread. La première valeur de l’énumération est toujours la valeur par défaut de l’utilisateur (remplacement). La fonction continue l’énumération jusqu’à ce que le dernier format soit trouvé ou que la fonction de rappel retourne FALSE.

À compter de Windows 8 : si votre application transmet des balises de langue à cette fonction à partir de l’espace de noms Windows.Globalization, elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête winnls.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

EnumTimeFormats

EnumTimeFormatsProcEx

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales