CInternetSession::CInternetSession

Artykuł
02/27/2013

Funkcja Członkowskie wywoływana podczas CInternetSession tworzony jest obiekt.

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

Parametry

pstrAgent
Wskaźnik ciąg identyfikujący nazwę aplikacji lub podmiot wywoływanie funkcji Internet (na przykład "Microsoft Internet Browser").Jeśli pstrAgent jest NULL (domyślnie), ramy wywołuje funkcję globalnego AfxGetAppName, która zwraca ciąg zakończony znakiem null, zawierające nazwę aplikacji.Niektóre protokoły Użyj tego ciągu do identyfikacji aplikacji na serwerze.
dwContext
Identyfikator kontekstu dla operacji.dwContextidentyfikuje informacje o stanie operacji zwrócony przez CInternetSession::OnStatusCallback.Domyślnie jest ustawiona na 1; Jednak jawnie przypisać identyfikator kontekstu określone dla operacji.Obiekt i wszelkich prac, które nie będą skojarzone z tym identyfikator kontekstu.
dwAccessType
Typ dostępu wymagane.Prawidłowe wartości, dokładnie jedna mogą być dostarczane są następujące:
- INTERNET_OPEN_TYPE_PRECONFIG używając wstępnie skonfigurowanych ustawień w rejestrze.Ten typ dostępu jest ustawiony jako domyślny.Połączyć za pośrednictwem serwera proxy t set dwAccessType tej wartości; następnie ustawieniu rejestru odpowiednio.
- INTERNET_OPEN_TYPE_DIRECTPodłączyć bezpośrednio do Internetu.
- INTERNET_OPEN_TYPE_PROXYPołączenia za pośrednictwem serwera proxy CERN.
Informacje dotyczące łączenia się z różnymi typami serwerów proxy, zobacz kroków w typowych aplikacji klienta FTP.
pstrProxyName
Nazwę preferowanego serwera proxy CERN Jeśli dwAccessType jest ustawiony jako INTERNET_OPEN_TYPE_PROXY.Wartością domyślną jest NULL.
pstrProxyBypass
Wskaźnik ciąg zawierający opcjonalna lista adresów serwera.Podczas korzystania z dostępu do serwera proxy może pominąć te adresy.Jeśli NULL podać wartość, Lista pomijania zostaną odczytane z rejestru.Ten parametr ma znaczenie tylko wtedy, gdy dwAccessType jest ustawiona na INTERNET_OPEN_TYPE_PROXY.
dwFlags
Wskazuje różne opcje buforowania.Wartość domyślna jest równa 0.Możliwe wartości:
- INTERNET_FLAG_DONT_CACHENie buforuj danych, lokalnie lub wszelkie serwery bram.
- INTERNET_FLAG_OFFLINEOperacji pobierania są spełnione poprzez trwałe pamięci podręcznej tylko.Jeśli element nie istnieje w pamięci podręcznej, zwracany jest kod błędu właściwe.Flaga ta może być połączone z bitowym OR ()|) operatora.

Uwagi

CInternetSession jest pierwsza funkcja Internet wywoływane przez aplikację.Wewnętrzne struktury danych inicjuje się i przygotowuje dla przyszłych połączeń z aplikacji.

Jeśli brak połączenia internetowego można otworzyć, CInternetSession wyrzuca AfxThrowInternetException.