InternetOpen 函数

初始化一个应用程序，以使用 WinINet 函数。

VB声明

Private Declare Function InternetOpen Lib "wininet.dll" Alias "InternetOpenA" _

(ByVal sAgent As String, _

ByVal lAccessType As Long, _

ByVal sProxyName As String, _

ByVal sProxyBypass As String, _

ByVal lFlags As Long) As Long

参数说明

sAgent

指定调用 WinINet 函数的应用程序或入口。该入口用作HTTP协议中用户代理项。

lAccessType

访问要求类型，该参数可为下列值之一：

INTERNET_OPEN_TYPE_DIRECT 解析所有本地主机；

INTERNET_OPEN_TYPE_PRECONFIG 返回注册表中代理或直接的配置；

INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY 返回注册表中代理或直接的配置，并防止对Microsoft Jscript 或 INS文件的使用；

INTERNET_OPEN_TYPE_PROXY 为代理传递请求，除非代理提供了旁路列表且解析的名字可以绕过代理；此时，函数使用INTERNET_OPEN_TYPE_DIRECT。

sProxyName

指定了当lAccessType类型为INTERNET_OPEN_TYPE_PROXY时，代理服务器的名字。

不要使用一个空的字符串，因为，该函数将使用它作为代理的名字。WinINet函数仅能识别OERN类型的代理和TIS网关。如果有安装IE，这些函数也同样支持SOCKS代理。FTP请求可由CERN类型代理或转换为HTTP请求，或使用InternetOpenUrl函数实现。

如果lAccessType类型未被设置为INTERNET_OPEN_TYPE_PROXY，该参数将被忽略且为NULL。

sProxyBypass

指向一个字符串，它指定一个可选的主机名列表或IP地址，列表可包括未知元素。

lFlags

该参数可为下列值的任意组合：

INTERNET_FLAG_ASYNC 仅能用于作用在该函数返回的句柄的子句柄上的异步请求。

INTERNET_FLAG_FROM_CACHE 不做网络请求。所有的实体都由缓存返回。如果请求条目不在缓存中，一个适当的错误将返回。

INTERNET_FLAG_OFFLINE 与 INTERNET_FLAG_FROM_CACHE 一样。

返回值

成功：返回一个有效的句柄，该句柄将由应用程序传递给接下来的WinINet函数。

失败：返回NULL。

备注

该函数是第一个由应用程序调用的 WinINet 函数。它告诉 Internet DLL 初始化内部数据结构并准备接收应用程序之后的其他调用。当应用程序结束使用 Internet 函数时，应调用 InternetCloseHandle 函数来释放与之相关的资源。

应用程序可以对该函数进行任意次数的调用，不过在一般情况下一次调用就已经足够了。如果要调用多次该函数，应用程序则有必要定义独立的函数实例的行为，诸如不同的代理服务器等。

要求

最低个人系统 Windows 2000 Professional

最低服务器 Windows 2000 Server

最低IE版本 Internet Explorer 3.0

DLL文件 Wininet.dll

（Unicode and ANSI names：InternetOpenW (Unicode) and InternetOpenA (ANSI)）