CInternetSession选件类

项目
03/01/2013

创建和初始化一个或多个同时Internet会话，并且，如果需要，在中，描述您的代理服务器的连接。

class CInternetSession : public CObject

成员

公共构造函数

名称	说明
CInternetSession::CInternetSession	构造 CInternetSession 对象。

公共方法

名称	说明
CInternetSession::Close	当Internet会话终止时，关闭Internet连接。
CInternetSession::EnableStatusCallback	建立一状态回调实例。
CInternetSession::GetContext	当Internet会话终止时，关闭Internet连接。
CInternetSession::GetCookie	返回指定的URL及其所有父的URL cookie。
CInternetSession::GetCookieLength	检索指定cookie的长度变量存储缓冲区。
CInternetSession::GetFtpConnection	开始使用服务器上的一个FTP会话。登录用户。
CInternetSession::GetGopherConnection	打开尝试打开连接的应用程序的一地鼠服务器。
CInternetSession::GetHttpConnection	打开尝试打开连接的应用程序的一个HTTP服务器。
CInternetSession::OnStatusCallback	在状态回调启用时，更新操作的状态。
CInternetSession::OpenURL	分析并打开URL。
CInternetSession::SetCookie	设置指定URL的cookie。
CInternetSession::SetOption	设置Internet会话的选项。

公共运算符

名称	说明
CInternetSession::operator HINTERNET	对当前Internet会话的句柄。

备注

如果需要应用程序的持续时间维护您的Internet连接，可以创建选件类 CWinApp的 CInternetSession 成员。

一旦创建了一个Internet会话，可以调用 OpenURL。CInternetSession 通过调用全局函数将分析您的URL AfxParseURL。无论协议类型，CInternetSession 解释URL和管理断点。它可以处理对本地文件标识的URL资源“file://”。OpenURL 将返回指向 CStdioFile 对象为通过它是否是本地文件。

使用 OpenURL，或者您在Internet服务器的URL，可以读取从站点的信息。如果要对位于服务器中的文件中对服务实现(例如，HTTP、FTP或地鼠)事件，必须生成与该服务器的适当连接。若要打开特定类型的连接来直接与特定的服务，请使用以下成员函数之一：

打开与地鼠服务的连接的GetGopherConnection。
打开与HTTP服务的连接的GetHttpConnection。
打开与FTP服务的连接的GetFtpConnection。

SetOption 允许您设置会话的查询选项，如超时值，重试次数的数字，依此类推。

CInternetSession 成员函数 SetCookie、 GetCookie和 GetCookieLength 提供用于管理Win32 cookie数据库，服务器和脚本维护客户端工作站的状态信息。

有关编程任务的基本Internet的更多信息，请参见文章 Internet第一步:WinInet。有关使用MFC WinInet选件类的一般信息，请参见文章编程时WinInet的Internet。

说明
CInternetSession 将引发不支持的服务类型的 AfxThrowNotSupportedException。只有以下服务类型是当前支持:FTP、HTTP、地鼠和文件。