通过

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 错误代码。

言论

对于 Shlwapi.h 中不包括 GetAcceptLanguages 的 Windows 版本，必须直接从 Shlwapi.dll调用此函数的单个 ANSI 或 Unicode 版本。 GetAcceptLanguagesA 为序号 14，GetAcceptLanguagesW 为序号 15。

某些网站提供多种语言的内容。 可以在控制面板的“Internet 选项”项中指定语言首选项。 GetAcceptLanguages 检索表示这些首选项的字符串。 在协商 HTTP 连接时，该字符串以其他语言标头发送。

注意 如果应用或服务将此函数中的语言标记传递给任何 国家语言支持 函数，或Microsoft .NET，则必须先通过 ResolveLocaleName 函数转换标记。
 

注意

shlwapi.h 标头将 GetAcceptLanguages 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
库 Shlwapi.lib
DLL Shlwapi.dll （版本 5.0 或更高版本）