CInternetConnection 类

项目
10/12/2023

管理与 Internet 服务器的连接。

语法

class CInternetConnection : public CObject

成员

公共构造函数

名称	描述
CInternetConnection::CInternetConnection	构造 `CInternetConnection` 对象。

公共方法

名称	描述
CInternetConnection::GetContext	获取此连接对象的上下文 ID。
CInternetConnection::GetServerName	获取与连接关联的服务器的名称。
CInternetConnection::GetSession	获取指向与连接关联的 CInternetSession 对象的指针。

公共运算符

“属性”	描述
CInternetConnection::operator HINTERNET	Internet 会话的句柄。

备注

它是 MFC 类 CFtpConnection、CHttpConnection 和 CGopherConnection 的基类。这些类中的每一个都提供了用于与相应的 FTP、HTTP 或 gopher 服务器进行通信的附加功能。

要直接与 Internet 服务器通信，必须有一个 CInternetSession 对象和一个 CInternetConnection 对象。

要详细了解 WinInet 类的工作原理，请参阅文章使用 WinInet 进行 Internet 编程。

继承层次结构

CObject

CInternetConnection

要求

标头：afxinet.h

CInternetConnection::CInternetConnection

创建 CInternetConnection 对象时会调用此成员函数。

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

参数

pSession
指向 CInternetSession 对象的指针。

pstrServer
指向包含服务器名称的字符串的指针。

nPort
标识此连接的 Internet 端口的数字。

dwContext
CInternetConnection 对象的上下文标识符。有关 dwContext 的详细信息，请参阅“注解”。

备注

你从不自己调用 CInternetConnection；相反，为要建立的连接类型调用 CInternetSession 成员函数：

dwContext 的默认值由 MFC 从创建 InternetConnection 派生对象的 CInternetSession 对象发送到 CInternetConnection 派生对象。默认值设置为 1；但是，可以在连接的 CInternetSession 构造函数中显式分配特定的上下文标识符。该对象及其执行的任何工作都将与该上下文 ID 相关联。上下文标识符将返回到 CInternetSession::OnStatusCallback，以提供标识它的对象的状态。有关上下文标识符的详细信息，请参阅 Internet 首要步骤：WinInet 一文。

CInternetConnection::GetContext

调用此成员函数以获取此会话的上下文 ID。

DWORD_PTR GetContext() const;

返回值

应用程序分配的上下文 ID。

备注

上下文 ID 最初在 CInternetSession 中指定，并传播到 CInternetConnection 和 CInternetFile 派生类，除非在对打开连接的函数的调用中以不同方式指定。上下文 ID 与给定对象的任何操作相关联，并标识 CInternetSession::OnStatusCallback 返回的操作状态信息。

若要详细了解如何使用 GetContext 其他 WinInet 类提供用户状态信息，请参阅 Internet 首要步骤：WinInet 一文，了解有关上下文标识符的详细信息。

CInternetConnection::GetServerName

调用此成员函数以获取与此 Internet 连接关联的服务器的名称。

CString GetServerName() const;

返回值

此连接对象正在使用的服务器的名称。

CInternetConnection::GetSession

调用此成员函数以获取指向与此连接关联的 CInternetSession 对象的指针。

CInternetSession* GetSession() const;

返回值

指向与此 Internet 连接对象关联的 CInternetSession 对象的指针。

CInternetConnection::operator HINTERNET

使用此运算符获取当前 Internet 会话的 API 级句柄。

operator HINTERNET() const;

另请参阅

CObject 类
 层次结构图

通过