Fonction EnumCalendarInfoW (winnls.h)

Article
03/04/2024

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

Note 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 régionaux pour les nouveaux paramètres régionaux, pour des raisons d’interopérabilité.

Note Toute application qui sera exécutée uniquement sur Windows Vista et versions ultérieures doit utiliser EnumCalendarInfoExEx de préférence pour EnumCalendarInfo.

Syntaxe

BOOL EnumCalendarInfoW(
  [in] CALINFO_ENUMPROCW 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 les 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 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

Consultez Les remarques relatives à EnumCalendarInfoEx.

Notes

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. 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