└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可以让查找和数据传输异步发生,允许使用者在传输结束时进行其它任务。如果要为使用者提供状态信息,或异步处理任意操作,必须设置三个条件:
1、在构造函数中,dwFlags必须包括INTERNET_FLAG_ASYNC。
2、在构造函数中,dwContext必须设置为1。
3、必须通过调用EnableStatusCallback来建立回调函数。
使用覆盖成员函数OnStatusCallback来获得异步获取的状态信息。使用此覆盖成员函数,必须从CInternetSession派生你自己的类。
注意:
CInternetSession将为不支持的服务类型产生一个AfxThrowNotSupportedException。当前只支持下列服务类型:FTP,HTTP,Gopher和文件。
#include <afxinet.h>
请参阅:
CInternetConnection, CHttpConnection
CInternetSession类的成员
构造函数
构造一个CInternetSession对象 |
属性
QueryOption | 为错误检查提供可能的断言 |
SetOption | 为Internet会话设置选项 |
文法分析映射并打开一个URL | |
打开一个与服务器的FTP会话。写入用户日志 | |
GetHttpConnection | 为试图打开连接的应用打开一个HTTP服务器 |
GetGopherConnection | 为试图打开连接的应用打开一个Gopher服务器 |
EnableStatusCallback | 建立一个状态回调例程。异步操作需要EnableStatusCallback |
ServiceTypeFromHandle | 从Internet句柄中得到服务器类型 |
操作
GetContext | 为Internet或应用会话获得上下文的值 |
当Internet会话终止时关闭Internet连接 | |
为指定的URL设置小程序 | |
GetCookie | 返回指定的URL的小程序及其所有父URL |
GetCookieLength | 获取确定存储在缓冲区的小程序的长度的变量 |
可覆盖的函数
OnStatusCallback | 当状态回调有效时,更新操作状态 |
操作符
operator HINTERNET | 当前Internet会话的句柄 |