Fonction EnumCalendarInfoExA (winnls.h)

Article
08/27/2023

Énumère les informations de calendrier pour un paramètre régional spécifié par l’identificateur.

Note Toute application qui s’exécute uniquement sur Windows Vista et versions ultérieures doit utiliser EnumCalendarInfoExEx de préférence pour cette fonction.

Syntaxe

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

Paramètres

[in] lpCalInfoEnumProcEx

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

[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 ou utiliser l’une des valeurs prédéfinies suivantes.

Windows Vista et versions ultérieures : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

[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

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 seul calendrier demandé, 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. Elle transmet à la fonction de rappel un pointeur vers une mémoire tampon contenant les informations de calendrier demandées. Ce processus se poursuit jusqu’à ce qu’EnumCalendarInfoEx trouve le dernier calendrier applicable 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, la fonction peut réussir, car le système d’exploitation 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 (?).

Notes

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


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