Fonction EnumCalendarInfoExExEx (winnls.h)

Article
08/27/2023

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

Note L’application doit appeler cette fonction de préférence à EnumCalendarInfo ou EnumCalendarInfoEx si elle est conçue pour s’exécuter uniquement sur Windows Vista et versions ultérieures.

Note Cette fonction peut énumérer les données qui changent d’une version à l’autre, par exemple en raison d’un paramètre régional personnalisé. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

Syntaxe

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Paramètres

[in] pCalInfoEnumProcExEx

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

[in, optional] lpLocaleName

Pointeur vers un nom de paramètres régionaux ou 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, optional] lpReserved

Réservés au; doit avoir la valeur NULL.

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

[in] lParam

Paramètre fourni par l’application à passer à la fonction de rappel. Cette valeur est particulièrement utile pour les applications multithread.

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

Cette fonction énumère les informations de calendrier pour tous les calendriers applicables pour les paramètres régionaux spécifiés, ou pour un calendrier demandé unique, en fonction de la valeur du paramètre Calendar . La fonction énumère les informations de calendrier en appelant la fonction de rappel définie par l’application spécifiée. Il transmet à la fonction de rappel un pointeur vers une mémoire tampon contenant les informations de calendrier demandées, un identificateur de calendrier et un paramètre défini par l’application qui est utile pour les applications multithread. Ce processus se poursuit jusqu’à ce qu’EnumCalendarInfoExEx trouve le dernier calendrier applicable ou que la fonction de rappel retourne FALSE.

À compter de Windows 8 : si votre application transmet des balises de langue à cette fonction à partir de l’espace de noms Windows.Globalization, elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

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