GetAcceptLanguagesW, fonction (shlwapi.h)

Article
11/20/2024

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

Syntaxe

LWSTDAPI GetAcceptLanguagesW(
  [out]     LPWSTR 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 de préférences linguistiques. Nous recommandons que cette mémoire tampon soit de taille de 2048 caractères pour garantir un espace suffisant pour retourner 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 à pszLanguages.

Lors de l’entrée, cette valeur est 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 de retour

Type : HRESULT

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

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 offrent du contenu dans plusieurs langues. Vous pouvez spécifier vos préférences linguistiques dans l’élément Options Internet dans le 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 de connexions HTTP.

Remarque Si votre application ou service passe des balises de langue de cette fonction à des fonctions National Language Support ou à Microsoft .NET, elle doit d’abord convertir les balises via la fonction ResolveLocaleName.

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via