CInternetSession::CInternetSession

Статья
02/20/2013

Этот объект CInternetSession функция-член вызывается после создания.

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

Параметры

pstrAgent
Указатель на строку, которая задает имя приложения, вызывающего функцию Интернета или сущности (например, "браузер Майкрософт в интернете").Если pstrAgentNULL (по умолчанию), то платформа вызывает функцию AfxGetAppName глобальной функции, которая возвращает имя null- завершенного строку, содержащую приложения.Для некоторых протоколов эта строка используется для определения приложения к серверу.
dwContext
Идентификатор контекста для операции.dwContext задает сведения о состоянии операции, возвращаемые CInternetSession::OnStatusCallback.Значение по умолчанию равно 1; однако можно явно присвоить определенный идентификатор контекста для операции.Объект и любые его делает будут сопоставлены с таким идентификатором контекста
dwAccessType
Требуемый тип доступа.Ниже приведены допустимые значения точно один из которых могут быть предоставлены:
- Соединение INTERNET_OPEN_TYPE_PRECONFIG с помощью предварительно настроенные параметры в реестре.Этот тип доступа установлен по умолчанию.Для подключения через прокси-сервер TIS, установите dwAccessType к этому значению; затем следует задать реестр.
- Соединение INTERNET_OPEN_TYPE_DIRECT непосредственно к Интернету.
- Соединение INTERNET_OPEN_TYPE_PROXY через прокси-сервер CERN.
Дополнительные сведения о подключения с различными типами учетных записях-посредниках см. в разделе Шаги в типичном клиентском приложении FTP.
pstrProxyName
Имя предпочтительного объекта прокси CERN если dwAccessType установлено как INTERNET_OPEN_TYPE_PROXY.Значение по умолчанию NULL.
pstrProxyBypass
Указатель на строку, содержащую необязательный список адресов сервера.Эти адреса можно обойти, при использовании доступа учетной записи-посредника.Если значение NULL указан, то список пропускаемых адресов будет прочитан из реестра.Этот параметр может применяться только в случае, если dwAccessType установлено в INTERNET_OPEN_TYPE_PROXY.
dwFlags
Указывает различные режимы кэширования.Значение по умолчанию равно 0.Возможные значения:
- INTERNET_FLAG_DONT_CACHE не кэширует данные или локально или на всех серверах шлюза.
- Операции загрузки INTERNET_FLAG_OFFLINE выполняются через постоянный кэш только для чтения.Если элемент не существует в кэше, то соответствующий код ошибки возвращается.Этот пометить может быть объединяется с OR (побитовый**|**) оператор.

Заметки

CInternetSession первая функция, вызываемая приложением через интернет.Он инициализирует внутренних структур данных и подготавливает для последующих вызовов от приложения.

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