Fonction EnumTimeFormatsA (winnls.h)
Énumère les formats de temps disponibles pour les paramètres régionaux spécifiés par l’identificateur.
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 les informations de format de temps. Vous pouvez utiliser la macro MAKELCID
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] dwFlags
Format d’heure. Ce paramètre peut spécifier une combinaison de l’une des valeurs suivantes.
Valeur de retour
Retourne une valeur différente de zéro si elle réussit ou 0 sinon. 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’est pas valide.
Remarques
La fonction énumère les formats d’heure en passant un pointeur vers une mémoire tampon contenant un format de temps 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 d’énumération jusqu’à ce que le format de la dernière heure soit trouvé ou que la fonction de rappel retourne FALSE.
Cette fonction peut énumérer les données de paramètres régionaux personnalisés. Les données ne sont pas garanties comme étant identiques de l’ordinateur à l’ordinateur 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 toutes les nouvelles valeurs de dwFlags introduites à l’avenir ne fonctionneront pas avec la version ANSI.
Note
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. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winnls.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |