internetSetOptionA 函数 (wininet.h)

项目
08/27/2023

设置 Internet 选项。

语法

BOOL InternetSetOptionA(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

参数

[in] hInternet

要对其设置信息的句柄。

[in] dwOption

要设置的 Internet 选项。这可以是选项标志值之一。

[in] lpBuffer

指向包含选项设置的缓冲区的指针。

[in] dwBufferLength

lpBuffer 缓冲区的大小。如果 lpBuffer 包含字符串，则大小以 TCHAR 为单位。如果 lpBuffer 包含字符串以外的任何内容，则大小以字节为单位。

返回值

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

注解

如果指定了无法设置的选项标志，GetLastError 将返回错误ERROR_INVALID_PARAMETER。

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

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

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

注意

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

要求


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