Fonction EnumCalendarInfoA (winnls.h)

Article
11/20/2024

Énumère les informations de calendrier pour les paramètres régionaux spécifiés.

Remarque Pour recevoir un identificateur de calendrier en plus des informations de calendrier, l’application doit utiliser la fonction EnumCalendarInfoEx. Une autre raison de préférer cette fonction est que Microsoft migre vers l’utilisation de noms de paramètres régionaux au lieu d’identificateurs de paramètres régionaux pour les nouveaux paramètres régionaux, pour des raisons d’interopérabilité.

Remarque Toute application qui sera exécutée uniquement sur Windows Vista et ultérieurement doit utiliser EnumCalendarInfoExex en préférence pour EnumCalendarInfo.

Syntaxe

BOOL EnumCalendarInfoA(
  [in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

Paramètres

[in] lpCalInfoEnumProc

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

[in] Locale

identificateur de paramètres régionaux qui spécifie les paramètres régionaux pour lesquels récupérer des informations de calendrier. 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] Calendar

'identificateur de calendrier qui spécifie le calendrier pour lequel les informations sont demandées. Notez que cet identificateur peut être ENUM_ALL_CALENDARS, pour énumérer tous les calendriers associés aux paramètres régionaux.

[in] CalType

Type d’informations de calendrier. Pour plus d’informations, consultez informations sur le type de calendrier. Un seul type de calendrier peut être spécifié par appel à cette fonction, sauf indication contraire.

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

Consultez les remarques pour EnumCalendarInfoEx.

Note

L’en-tête winnls.h définit EnumCalendarInfo 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