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会话的句柄