Функция GetAcceptLanguagesA (shlwapi.h)

Статья
11/20/2024

Извлекает строку, используемую с веб-сайтами при указании языковых параметров.

Синтаксис

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

Параметры

[out] pszLanguages

Тип: LPTSTR

Указатель на строку, которая, когда эта функция возвращается успешно, получает сведения о языковых предпочтениях. Рекомендуется, чтобы этот буфер был размером 2048 символов, чтобы обеспечить достаточно места для возврата полной строки. Вы также можете вызвать эту функцию с этим параметром значение NULL, чтобы получить размер строки, которая будет возвращена.

[in, out] pcchLanguages

Тип: DWORD*

Указатель на размер строки в символах pszLanguages.

В записи это значение равно размеру pszLanguages, включая завершающийся символ NULL.

При выходе фактический размер pszLanguages, не включая завершающийся символ NULL.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Для тех версий Windows, которые не включают GetAcceptLanguages в Shlwapi.h, отдельная версия ANSI или Юникода должна вызываться непосредственно из Shlwapi.dll. GetAcceptLanguagesA имеет порядковый номер 14 и GetAcceptLanguagesW порядковый номер 15.

Некоторые веб-сайты предлагают содержимое на нескольких языках. Параметры языка можно указать в элементе "Параметры браузера" на панели управления. GetAcceptLanguages извлекает строку, представляющую эти настройки. Эта строка отправляется в дополнительный заголовок языка при согласовании HTTP-подключений.

Примечание Если приложение или служба передает теги языка из этой функции в любую функцию поддержки национального языка или в Microsoft .NET, необходимо сначала преобразовать теги через функцию ResolveLocaleName.

Заметка

Заголовок shlwapi.h определяет GetAcceptLanguages в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

Поделиться через