CInternetSession::CInternetSession

CInternetSession 对象之后,该成员函数的调用。

CInternetSession(
   LPCTSTR pstrAgent = NULL,
   DWORD_PTR dwContext = 1,
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
   LPCTSTR pstrProxyName = NULL,
   LPCTSTR pstrProxyBypass = NULL,
   DWORD dwFlags = 0 
);

参数

  • pstrAgent
    对例如确定调用Internet功能的字符串的指针(“,Microsoft Internet浏览器”)的该应用程序或实体的名称。 如果 pstrAgent 是 NULL (默认值)时,框架调用全局函数 AfxGetAppName,返回包含应用程序名传递一个Null终止的字符串。 这些协议使用该字符串用于标识应用程序到服务器。

  • dwContext
    操作的上下文标识符。 dwContext 标识 CInternetSession::OnStatusCallback返回的操作的状态信息。 该默认设置为1;但是,可以为操作显式分配特定上下文ID。 它的对象及其所有工作要与该上下文ID.

  • dwAccessType
    需要访问的类型。 下面是有效值,其中可能已正确配置:

    • 使用在注册表中,的预先配置的设置INTERNET_OPEN_TYPE_PRECONFIG 连接。 此访问类型设置为默认值。 通过TIS代理若要连接,请设置 dwAccessType 为该值;已正确然后设置注册表。

    • INTERNET_OPEN_TYPE_DIRECT 直接连接到Internet。

    • INTERNET_OPEN_TYPE_PROXY 通过CERN代理连接。

    有关与代理的不同类型的信息,请参见 在典型的FTP客户端应用程序的步骤

  • pstrProxyName
    首选CERN代理的名称,如果 dwAccessType 设置为 INTERNET_OPEN_TYPE_PROXY。 默认值为 NULL

  • pstrProxyBypass
    对包含选项的字符串的指针列表服务器地址。 在使用代理访问时,这些地址可能使用。 如果提供 NULL 值,跳过列表从注册表中读取。 仅当 dwAccessType 设置为 INTERNET_OPEN_TYPE_PROXY,此参数是有意义的。

  • dwFlags
    指示各种缓存选项。 该默认设置为0。 可能的值包括:

    • INTERNET_FLAG_DONT_CACHE 不缓存数据,或是在任何网关服务器。

    • INTERNET_FLAG_OFFLINE 下载操作只能通过持久性缓存满足的。 如果该项不在缓存存在,相应的错误代码返回。 此标志可以按位组合使用 OR ( |)运算符。

备注

CInternetSession 是应用程序调用的第一个Internet功能。 它初始化内部数据结构并为其准备从应用程序调用。

如果不能打开Internet连接,CInternetSession 引发 AfxThrowInternetException

示例

CFtpFileFind参见示例。

要求

Header: afxinet.h

请参见

参考

CInternetSession选件类

层次结构图

CInternetSession::Close

CInternetSession::EnableStatusCallback

CInternetSession::GetContext