CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent = NULL, DWORD dwContext = 1, DWORD dwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, LPCTSTR pstrProxyName = NULL, LPCTSTR, pstrProxyBypass = NULL, DWORD dwFlags = 0);

Параметры

pstrAgent

Указатель на строку, которая идентифицирует имя приложения или сущности, вызова функций Интернета (например, "Microsoft Интернет браузер"). Если pstrAgent равен NULL (по умолчанию), платформа вызывает глобальной функции AfxGetAppName, которая возвращает нулем строку, содержащую имя приложения. Некоторые протоколы использовать данную строку для идентификации приложения на сервере.

dwContext

Идентификатор контекста для операции. dwContext определяет сведения о состоянии операции, возвращенный CInternetSession::OnStatusCallback. По умолчанию устанавливается значение 1; Однако можно явно присвоить Идентификатор определенного контекста для операции. Объект и любые работы, он будет связан с этим идентификатором контекста. Если dwFlags включает INTERNET_FLAG_ASYNC, то объекты, создаваемые данным объектом иметь асинхронное поведение, если зарегистрированный статус подпрограммы обратного вызова. Для того чтобы функция завершена синхронно dwContext должно быть равным нулю для этого звонка.

dwAccessType

Тип необходимых прав доступа. Ниже приведены допустимые значения, только один из которых могут поставляться:

pstrProxyName

Имя предпочтительного CERN прокси если dwAccessType имеет значение как INTERNET_OPEN_TYPE_PROXY. Значение по умолчанию — NULL.

pstrProxyBypass

Указатель на строку, содержащую необязательный список адресов серверов. Эти адреса могут обойти при использовании прокси доступа. Если задано пустое значение, список пропускаемых адресов будет прочитать из реестра. Этот параметр имеет смысл только в том случае, если dwAccessType имеет значение INTERNET_OPEN_TYPE_PROXY.

dwFlags

Указывает различные варианты, такие как кэширование и асинхронного поведения. По умолчанию имеет значение 0. Возможные значения:

Примечания

Эта функция-член вызывается при создании объекта CInternetSession . CInternetSession это первый Интернет функции, вызванной приложением. Он инициализирует внутренние структуры данных и готовит для будущих вызовов из приложения.

Если dwFlags включает в себя INTERNET_FLAG_ASYNC, то все дескрипторы, производный от данного дескриптора будет иметь асинхронного поведения, пока зарегистрировано подпрограммы обратного вызова статус.

Если нет подключения к Интернету может быть открыт, CInternetSession выдает AfxThrowInternetException.

Обзор CInternetSession |nbsp; Члены класса | Иерархическая схема

См. также CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext

Index