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; Однак, можна призначити явно конкретному контексті Посвідчення для операції. Об'єкт і будь-яку роботу, він робить будуть пов'язані з ID що контекст. Якщо dwFlags включає в себе INTERNET_FLAG_ASYNC, то об'єкти, створені за цей об'єкт є асинхронних поведінкою тих пір, як зареєстрований зворотний виклик статус звичайної. Для того, щоб функція буде завершена синхронно dwContext має бути встановлено на нуль на цей заклик.

dwAccessType

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

• I&NTERNET_OPEN_TYPE_PRECONFIGnbsp;  У вихідному стані (у реєстрі). Цей тип доступу встановлено за замовчуванням.
  
  
• I&NTERNET_OPEN_TYPE_DIRECTnbsp;  Безпосередньо до Інтернету.
  
  
• I&NTERNET_OPEN_TYPE_PROXYnbsp;  Через проксі-сервер CERN.

pstrProxyName

Ім'я бажаних ЦЕРН проксі, якщо dwAccessType встановлено як INTERNET_OPEN_TYPE_PROXY. За замовчуванням дорівнює NULL.

pstrProxyBypass

Вказівник на рядок, який містить це необов'язковий список з адреси сервера. Ці адреси буде виконана за допомогою проксі-сервера доступу. Якщо значення NULL поставляється, обійти список буде читати з реєстру. Цей параметр має сенс тільки якщо dwAccessType INTERNET_OPEN_TYPE_PROXY.

dwFlags

Вказує різні параметри, такі як кешування і асинхронних поведінкою. За промовчанням встановлено на 0. Можливі значення:

• I&NTERNET_FLAG_DONT_CACHEnbsp;  Не кешувати дані, на локальному комп'ютері або в будь-який шлюзові сервери.
  
  
• I&NTERNET_FLAG_ASYNCnbsp;  Майбутніх операцій на цей об'єкт може не з ERROR_IO_PENDING. Статус виклику буде зроблено з INTERNET_STATUS_REQUEST_COMPLETE , після завершення операції. Це зворотного виклику знаходиться на потік, інші, ніж для запрошення. Ви повинні викликати EnableStatusCallback встановити звичайні зворотний виклик статус, або функції буде завершено синхронно.
  
  
• I&NTERNET_FLAG_OFFLINEnbsp;  Завантажити операцій задоволені через постійні кеш тільки. Якщо елемент не існує в кеш-пам'яті, повертаються відповідні помилку коду. Цей прапор можуть бути об'єднані з порозрядне оператор OR (|).

Зауваження

Цей член функція викликається під час створення об'єкта CInternetSession . CInternetSession є перший Інтернет функція називається застосунком. Це ініціалізує внутрішні дані структури і готує для майбутніх дзвінків з застосування.

Якщо dwFlags включає в себе INTERNET_FLAG_ASYNC, то всі маркери, отриманих від цього маркера буде мати асинхронних поведінкою тих пір, як зареєстрований зворотний виклик статус звичайної.

Якщо немає підключення до Інтернету можна відкрити, CInternetSession кидає в AfxThrowInternetException.

Огляд CInternetSession |nbsp; Члени класу | Ієрархічна діаграма

Дивіться також CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext