CInternetSession::CInternetSession

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

Parametry

pstrAgent

Wskaźnik ciąg identyfikujący nazwę aplikacji lub podmiot wywoływanie funkcji Internetu (na przykład, "Microsoft Internet Browser"). Jeśli pstrAgent ma wartość NULL (wartość domyślna), ramy wywołuje funkcja globalna AfxGetAppName, która zwraca ciąg zakończony zerem, zawierające nazwę aplikacji. Niektóre protokoły Użyj tego ciągu do identyfikacji aplikacji serwera.

dwContext

Identyfikator kontekstu dla operacji. dwContext określa informacje o statusie operacji zwrócony przez CInternetSession::OnStatusCallback. Domyślne jest ustawione na 1; Jednakże można jawnie przypisać Identyfikatora specyficzny kontekst dla operacji. Obiekt i wszelkich prac, które nie zostaną skojarzone z tym identyfikatorem kontekstu. Jeśli dwFlags zawiera INTERNET_FLAG_ASYNC, obiekty utworzone przez ten obiekt ma asynchronicznego zachowanie, tak długo, jak długo stan rutynowych wywołania zwrotnego jest zarejestrowany. Aby funkcja wypełnić synchronicznie dwContext ma być ustawione na zero dla tego wywołania.

dwAccessType

Typ dostępu wymagane. Poniżej podano prawidłowe wartości, dokładnie jeden z nich może być dostarczone:

pstrProxyName

Nazwy preferowanego serwera proxy CERN ustawienie dwAccessType jako INTERNET_OPEN_TYPE_PROXY. Domyślną wartością jest NULL.

pstrProxyBypass

Wskaźnik ciąg zawierający opcjonalna lista adresów serwera. Te adresy mogą pominięte podczas korzystania z serwera proxy dostępu. Jeśli podana jest wartość NULL , Lista pomijania będzie można odczytać z rejestru. Ten parametr ma znaczenie tylko wtedy, gdy dwAccessType jest ustawiona na INTERNET_OPEN_TYPE_PROXY.

dwFlags

Wskazuje różne opcje, takie jak zachowanie buforowania i asynchronicznych. Wartość domyślna jest równa 0. Możliwe wartości:

Uwagi

Ta funkcja Członkowskie nosi nazwę po utworzeniu obiektu CInternetSession . CInternetSession jest pierwsza funkcja Internet wywołana przez aplikację. Inicjuje wewnętrzne struktury danych i przygotowuje się do przyszłych rozmów z aplikacji.

Jeśli dwFlags zawiera INTERNET_FLAG_ASYNC, następnie wszystkie dojścia pochodzące z tego uchwytu będzie zachowanie asynchronicznego tak długo, jak długo stan rutynowych wywołania zwrotnego jest zarejestrowany.

Jeśli nie połączenie internetowe mogą być otwierane, CInternetSession generuje AfxThrowInternetException.

Omówienie CInternetSession |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext

Index