Fonction EnumTimeFormatsW (winnls.h)

Article
08/27/2023

Énumère les formats d’heure disponibles pour les paramètres régionaux spécifiés 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 de paramètres 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 EnumTimeFormatsW(
  [in] TIMEFMT_ENUMPROCW 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 les informations de format d’heure. 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 fonctionne 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 codes ANSI (ACP) Windows par défaut au lieu de la page de codes 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 poursuit 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 codes système. Toutefois, les caractères qui ne sont pas définis dans la page de codes système apparaissent dans la chaîne sous la forme d’un 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 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. La combinaison 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

Partager via