Fonction EnumTimeFormatsA (winnls.h)

  • Article

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

Note Pour des raisons d’interopérabilité, l’application doit préférer la fonction EnumTimeFormatsEx à EnumTimeFormats , car Microsoft migre vers l’utilisation de noms régionaux au lieu d’identificateurs régionaux pour les nouveaux paramètres régionaux. Toute application qui s’exécute uniquement sur Windows Vista et versions ultérieures doit utiliser EnumTimeFormatsEx.
 

Syntaxe

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

Paramètres

[in] lpTimeFmtEnumProc

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

[in] Locale

Identificateur de paramètres régionaux qui spécifie les paramètres régionaux pour lesquels récupérer des informations de format de temps. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur de paramètres régionaux ou utiliser l’une des valeurs prédéfinies suivantes.

[in] dwFlags

Format d’heure. Ce paramètre peut spécifier une combinaison de l’une des valeurs suivantes.

Indicateur Signification
0
 Utilisez le format de temps long de l’utilisateur actuel.
TIME_NOSECONDS
 Windows 7 et versions ultérieures : utilisez le format de temps court de l’utilisateur actuel.
Note Cette valeur ne fonctionnera pas avec la version ANSI de cette fonction, EnumTimeFormatsA.
 
LOCAL_USE_CP_ACP
 Spécifié avec la version ANSI de cette fonction, EnumTimeFormatsA (non recommandé), pour utiliser la page de code ANSI Windows par défaut (ACP) par défaut au lieu de la page de code des paramètres régionaux.

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

La fonction énumère les formats d’heure en passant un pointeur vers une mémoire tampon contenant un format d’heure vers une fonction de rappel définie par l’application. 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.

Cette fonction peut énumérer des données à partir de paramètres régionaux personnalisés. Il n’est pas garanti que les données soient identiques d’un ordinateur à l’autre ou entre les exécutions d’une application. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

Lorsque la version ANSI de cette fonction est utilisée avec un identificateur de paramètres régionaux Unicode uniquement, l’appel peut réussir, car le système utilise la page de code système. Toutefois, les caractères qui ne sont pas définis dans la page de code système apparaissent dans la chaîne sous forme de point d’interrogation (« ? »). Notez que les nouvelles valeurs de dwFlags introduites à l’avenir ne fonctionneront pas avec la version ANSI.

Notes

L’en-tête winnls.h définit EnumTimeFormats comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

Voir aussi

EnumTimeFormatsEx

EnumTimeFormatsProc

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales