GetAcceptLanguagesA, fonction (shlwapi.h)
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.
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) |