InternetQueryOptionA 函数（wininet.h）

项目
11/20/2024

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

语法

BOOL InternetQueryOptionA(
  [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 服务（WinHTTP）。

注意

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

要求

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