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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)