InternetQueryOptionW 函数 (wininet.h)

项目
03/04/2024

查询指定句柄上的 Internet 选项。

语法

BOOL InternetQueryOptionW(
  [in]      HINTERNET hInternet,
  [in]      DWORD     dwOption,
  [out]     LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength
);

参数

[in] hInternet

查询信息所基于的句柄。

[in] dwOption

要查询的 Internet 选项。这可以是选项标志值之一。

[out] lpBuffer

指向接收选项设置的缓冲区的指针。 InternetQueryOption 返回的字符串是全局分配的，因此调用应用程序在使用完这些字符串后必须释放它们。

[in, out] lpdwBufferLength

指向包含 lpBuffer 大小的变量（以字节为单位）的指针。 当 InternetQueryOption 返回时，lpdwBufferLength 指定放入 lpBuffer 的数据的大小。如果 GetLastError 返回ERROR_INSUFFICIENT_BUFFER，则此参数指向保存所请求信息所需的字节数。

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。若要获取特定错误消息，请调用 GetLastError。

注解

如果将对指定句柄类型无效的选项标志传递给 dwOption 参数，GetLastError 将返回ERROR_INVALID_PARAMETER。

有关详细信息，请参阅
设置和检索 Internet 选项。

与 WinINet API 的所有其他方面一样，无法从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。此外，不应从服务使用它。对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wininet.h
Library	Wininet.lib
DLL	Wininet.dll