Класс CInternetSession
Класс CInternetSession представляет сеанс. Вы должны создать объект класса CInternetSession перед использованием остальных классов и методов WinInet. Вы можете либо непосредственно создать объект класса CInternetSession, либо сначала наседовать от класса CInternetSession собственный клас и использовать уже его.
Класс CInternetSession наследуется от базового класса CObject, лежащего в основе большинства классов библиотеки MFC:
CObject -> CInternetSession
Кроме конструктора, в состав класса CInternetSession входят несколько методов, выполняющих разнообразные действия. Они позволяют определить и изменить характеристиками данного сеанса связи, открыть для чтения объект на указанном сервере Internet, установить соединение с серверами FTP, WWW и Gopher и т. д. В следующей таблице мы привели список этих методов:
Метод | Описание | ||
CInternetSession
| Конструктор класса CInternetSession | ||
Close | Закрывает соединение с Internet. Вы должны вызвать этот метод после того, как вы закончите использовать объект CInternetSession | ||
EnableStatusCallback | Управляет работой функции обратного вызова WinInet. Эта функция реализована как метод OnStatusCallback класса CInternetSession | ||
GetContext | Определяет значение идентификатора контекста для данного сеанса связи | ||
GetFtpConnection | Устанавливает сеанс связи с сервером FTP | ||
GetGopherConnection | Устанавливает сеанс связи с сервером Gopher | ||
GetHttpConnection | Устанавливает сеанс связи с сервером WWW | ||
HINTERNET | Возвращает идентификатор текущего сеанса связи с Internet | ||
OnStatusCallback | Данный метод вызывается когда изменяется состояние сеанса связи. Чтобы разрешить использование этой функции необходимо воспользоваться методом EnableStatusCallback | ||
OpenURL | Открывает объект, расположенный по заданному адресу URL, для загрузки в локальный компьютер | ||
QueryOption | Запрашивает различные характеристики соединения с Internet. Например время, по истечении которого, запрос отменяется в случае если на него не получен ответ, размеры буферов, используемых для чтения и записи и т. д. Вы можете менять все эти характеристики при помощи метода SetOption, также входящего в класс CInternetSession | ||
ServiceTypeFromHandle | Определить тип сервиса (ftp, http, gopher, file), соответствующий данному идентификатору | ||
SetOption | Устанавливает различные параметры сеанса связи с Internet. Чтобы узнать значение текущих параметров связи следует воспользоваться методом QueryOption |
Рассмотрим более подробно конструктор класса и те его методы, которые будут нами использоваться в дальнейшем.