GetAcceptLanguagesA, fonction (shlwapi.h)

Article
03/02/2024

Récupère une chaîne utilisée avec des sites web lors de la spécification des préférences de langue.

Syntaxe

LWSTDAPI GetAcceptLanguagesA(
  [out]     LPSTR pszLanguages,
  [in, out] DWORD *pcchLanguages
);

Paramètres

[out] pszLanguages

Type : LPTSTR

Pointeur vers une chaîne qui, lorsque cette fonction retourne correctement, reçoit les informations relatives aux préférences de langue. Nous recommandons que cette mémoire tampon ait une taille de 2 048 caractères pour garantir un espace suffisant pour renvoyer la chaîne complète. Vous pouvez également appeler cette fonction avec ce paramètre défini sur NULL pour récupérer la taille de la chaîne qui sera retournée.

[in, out] pcchLanguages

Type : DWORD*

Pointeur vers la taille, en caractères, de la chaîne sur pszLanguages.

Lors de l’entrée, cette valeur correspond à la taille de pszLanguages, y compris le caractère null de fin.

À la sortie, il s’agit de la taille réelle de pszLanguages, sans inclure le caractère null de fin.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour les versions de Windows qui n’incluent pas GetAcceptLanguages dans Shlwapi.h, la version ANSI ou Unicode individuelle de cette fonction doit être appelée directement à partir de Shlwapi.dll. GetAcceptLanguagesA est ordinal 14 et GetAcceptLanguagesW est ordinal 15.

Certains sites web proposent du contenu dans plusieurs langues. Vous pouvez spécifier vos préférences linguistiques dans l’élément Options Internet dans Panneau de configuration. GetAcceptLanguages récupère une chaîne qui représente ces préférences. Cette chaîne est envoyée dans un en-tête de langue supplémentaire lors de la négociation des connexions HTTP.

Note Si votre application ou service transmet des balises de langue de cette fonction à n’importe quelle fonction de prise en charge des langues nationales ou à Microsoft .NET, il doit d’abord convertir les balises via la fonction ResolveLocaleName .

Notes

L’en-tête shlwapi.h définit GetAcceptLanguages comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via