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

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

  • Статья

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

Синтаксис

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 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)