Класс CInternetConnection

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Управление подключением к интернет-серверу.

Синтаксис

class CInternetConnection : public CObject

Участники

Открытые конструкторы

Имя	Описание
CInternetConnection::CInternetConnection	Формирует объект CInternetConnection.

Открытые методы

Имя	Описание
CInternetConnection::GetContext	Возвращает идентификатор контекста для этого объекта подключения.
CInternetConnection::GetServerName	Возвращает имя сервера, связанного с подключением.
CInternetConnection::GetSession	Возвращает указатель на объект CInternetSession , связанный с соединением.

Открытые операторы

Имя	Описание
CInternetConnection::operator HINTERNET	Дескриптор сеанса Интернета.

Замечания

Это базовый класс для классов CFtpConnection, CHttpConnection и CGopherConnection. Каждый из этих классов предоставляет дополнительные функциональные возможности для взаимодействия с соответствующим СЕРВЕРом FTP, HTTP или gopher.

Для прямого взаимодействия с Интернет-сервером необходимо иметь объект CInternetSession и CInternetConnection объект.

Дополнительные сведения о работе классов WinInet см. в статье "Интернет-программирование с помощью WinInet".

Иерархия наследования

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
Номер, определяющий порт Интернета для этого подключения.

dwContext
Идентификатор контекста CInternetConnection для объекта. Дополнительные сведения о dwContext см. в примечаниях.

Замечания

Вы никогда не вызываете себя. Вместо этого вызовите CInternetConnectionфункцию-член CInternetSession для типа соединения, которое требуется установить:

• CInternetSession::GetFtpConnection

• CInternetSession::GetHttpConnection

• CInternetSession::GetGopherConnection

Значение по умолчанию для dwContext отправляется MFC в производный объект от объекта CInternetSession, создавшего объект, производный CInternetConnection. Значение по умолчанию равно 1; однако можно явно назначить определенный идентификатор контекста в конструкторе CInternetSession для подключения. Объект и любая работа, которую она выполняет, будет связана с этим идентификатором контекста. Идентификатор контекста возвращается в CInternetSession::OnStatusCallback , чтобы предоставить состояние объекта, с которым он определен. Дополнительные сведения об идентификаторе контекста см. в статье Internet First Steps: WinInet .

CInternetConnection::GetContext

Вызовите эту функцию-член, чтобы получить идентификатор контекста для этого сеанса.

DWORD_PTR GetContext() const;

Возвращаемое значение

Идентификатор контекста, назначаемого приложением.

Замечания

Идентификатор контекста изначально указывается в CInternetSession и распространяется на CInternetConnectionклассы, производные от CInternetFile, если в вызове функции, открывшей соединение, не указано по-другому. Идентификатор контекста связан с любой операцией данного объекта и определяет сведения о состоянии операции, возвращаемые CInternetSession::OnStatusCallback.

Дополнительные сведения о том, как GetContext работает с другими классами WinInet для предоставления сведений о состоянии пользователя, см. в статье Internet First Steps: WinInet для получения дополнительных сведений об идентификаторе контекста.

CInternetConnection::GetServerName

Вызовите эту функцию-член, чтобы получить имя сервера, связанного с этим подключением к Интернету.

CString GetServerName() const;

Возвращаемое значение

Имя сервера, с которым работает объект подключения.

CInternetConnection::GetSession

Вызовите эту функцию-член, чтобы получить указатель на CInternetSession объект, связанный с этим подключением.

CInternetSession* GetSession() const;

Возвращаемое значение

Указатель на объект CInternetSession, связанный с этим объектом подключения к Интернету.

CInternetConnection::operator HINTERNET

Используйте этот оператор, чтобы получить дескриптор уровня API для текущего сеанса Интернета.

operator HINTERNET() const;

См. также

Класс CObject
Диаграмма иерархии