SetCalendarInfoA, fonction (winnls.h)

Définit un élément d’informations de paramètres régionaux pour un calendrier. Pour plus d’informations, consultez Date et Calendrier.

Syntaxe

BOOL SetCalendarInfoA(
  [in] LCID    Locale,
  [in] CALID   Calendar,
  [in] CALTYPE CalType,
  [in] LPCSTR  lpCalData
);

Paramètres

[in] Locale

Identificateur de paramètres régionaux qui spécifie les paramètres régionaux. 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.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[in] Calendar

Identificateur de calendrier pour le calendrier pour lequel définir des informations.

[in] CalType

Type d’informations de calendrier à définir. Seules les valeurs CALTYPE suivantes sont valides pour cette fonction. La constante CAL_USE_CP_ACP n’est significative que pour la version ANSI de la fonction.

• CAL_USE_CP_ACP
• CAL_ITWODIGITYEARMAX

L’application ne peut spécifier qu’un seul identificateur de calendrier par appel à cette fonction. Une exception peut être effectuée si l’application utilise l’opérateur binaire OR pour combiner CAL_USE_CP_ACP avec n’importe quelle valeur CALTYPE valide définie dans informations sur le type de calendrier.

[in] lpCalData

Pointeur vers une chaîne d’informations de calendrier terminée par null. Les informations doivent être au format du type de calendrier spécifié.

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_INTERNAL_ERROR. Une erreur inattendue s’est produite dans la fonction .
• 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 affecte uniquement la partie de remplacement utilisateur des paramètres de calendrier. Il ne définit pas les valeurs système par défaut.

Les informations de calendrier sont toujours passées sous forme de chaîne Unicode terminée par null dans la version Unicode de cette fonction, et sous forme de chaîne ANSI terminée par null dans la version ANSI. Aucun entier n’est autorisé par cette fonction. Toutes les valeurs numériques doivent être spécifiées en tant que texte Unicode ou ANSI.

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 (?).

CAL_ITWODIGITYEARMAX peut être utilisé avec n’importe quel calendrier, même si le calendrier n’est pas pris en charge pour les paramètres régionaux spécifiés. Pour éviter les complications, l’application doit appeler EnumCalendarInfo pour s’assurer que le calendrier est pris en charge pour les paramètres régionaux intéressants.

Notes

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

Voir aussi

EnumCalendarInfo

GetCalendarInfo

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales