CInternetSession

CObject
 └CInternetSession

使用类CInternetSession 创建并初始化一个或多个同时的Internet 会话。如果需要,还可描述与代理服务器的连接。如果Internet连接必须在应用过程中保持着,可创建一个类CWinApp的CInternetSession成员。一旦已建立起Internet 会话,就可调用OpenURL。CInternetSession会通过调用全局函数AfxParseURL来为分析映射URL。无论协议类型如何,CInternetSession 解释URL并管理它。它可处理由URL资源“file://”标志的本地文件的请求。如果传给它的名字是本地文件,OpenURL 将返回一个指向CStdioFile对象的指针。
如果使用OpenURL在Internet服务器上打开一个URL,你可从此处读取信息。如果要执行定位在服务器上的指定的服务(例如,HTTP,FTP或Gopher)行为,必须与此服务器建立适当的连接。直接打开与指定的服务器的指定的类型的连接,请使用下列成员函数:
·GetGopherConnection打开与Gopher服务的连接。
·GetHttpConnection打开与HTTP服务的连接。
·GetFtpConnection打开与FTP服务的连接。
QueryOption和SetOption允许设置会话的查询选项,如超时值、再试次数等等。
Internet会话过程中,象查找或数据下载这样的事务处理会占用一定的时间。使用者可能想继续工作,或获得事务处理进程的状态信息。为解决这个问题,CInternetSession可以让查找和数据传输异步发生,允许使用者在传输结束时进行其它任务。如果要为使用者提供状态信息,或异步处理任意操作,必须设置三个条件:
·在构造函数中,dwFlags必须包括INTERNET_FLAG_ASYNC。
·在构造函数中,dwContext必须设置为1。
·必须通过调用EnableStatusCallback来建立回调函数。
使用覆盖成员函数OnStatusCallback来获得异步获取的状态信息。使用此覆盖成员函数,必须从CInternetSession派生你自己的类。
要了解异步操作的更多信息,请参阅联机文档“Visual C++程序员指南”中的“Internet初步:WinInet”。要了解使用MFC WinInet 类的一般信息,请参阅联机文档“Visual C++程序员指南”中的“使用WinInet编写Internet程序”。
注意:
CInternetSession将为不支持的服务类型产生一个AfxThrowNotSupportedException。当前只支持下列服务类型:FTP,HTTP,Gopher和文件。
#include <afxinet.h>

请参阅:
CInternetConnection, CHttpConnection, CFtpConnection, CGopherConnection


CInternetSession类的成员

构造函数
CInternetSession构造一个CInternetSession对象

属性
QueryOption为错误检查提供可能的断言
SetOption为Internet会话设置选项
OpenURL文法分析映射并打开一个URL
GetFtpConnection打开一个与服务器的FTP会话。写入用户日志
GetHttpConnection为试图打开连接的应用打开一个HTTP服务器
GetGopherConnection为试图打开连接的应用打开一个Gopher服务器
EnableStatusCallback建立一个状态回调例程。异步操作需要EnableStatusCallback
ServiceTypeFromHandle从Internet句柄中得到服务器类型

操作
GetContext为Internet或应用会话获得上下文的值
Close当Internet会话终止时关闭Internet连接
SetCookie为指定的URL设置小程序
GetCookie返回指定的URL的小程序及其所有父URL
GetCookieLength获取确定存储在缓冲区的小程序的长度的变量

可覆盖的函数
OnStatusCallback当状态回调有效时,更新操作状态

操作符
operator HINTERNET当前Internet会话的句柄