Sdílet prostřednictvím


CInternetSession::CInternetSession

Tento člen funkce je volána při CInternetSession je vytvořen objekt.

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
    Ukazatel na řetězec, který určuje název aplikace nebo entita volání funkcí sítě Internet (například "Microsoft Internet prohlížeče").Pokud pstrAgent je NULL (výchozí) rámci volání globální funkce AfxGetAppName, která vrací řetězec zakončený obsahující název aplikace.Některé protokoly k identifikaci aplikace serveru použít tento řetězec.

  • dwContext
    Kontext identifikátor operace.dwContextidentifikuje vrácené informace o stavu operace CInternetSession::OnStatusCallback.Výchozí hodnota je nastavena na 1; však výslovně přiřadíte ID kontextu určité operace.Bude objekt a žádnou práci, kterou je spojen s tímto ID kontextu.

  • dwAccessType
    Typ vyžadována.Platné hodnoty, přesně jedna z nich dodávané jsou následující:

    • INTERNET_OPEN_TYPE_PRECONFIG připojit pomocí předem nakonfigurovaných nastavení v registru.Tento typ přístupu je nastavena jako výchozí.Nastavit připojení k serveru proxy TIS, dwAccessType na tuto hodnotu; potom nastavíte registru správně.

    • INTERNET_OPEN_TYPE_DIRECTPřímé připojení k Internetu.

    • INTERNET_OPEN_TYPE_PROXYPřipojení prostřednictvím serveru proxy CERN.

    Informace o připojení s různými typy serverů proxy, viz krocích v typické aplikace klienta FTP.

  • pstrProxyName
    Název upřednostňovaného serveru proxy CERN Pokud dwAccessType je nastavena jako INTERNET_OPEN_TYPE_PROXY .Výchozí hodnota je NULL.

  • pstrProxyBypass
    Ukazatel na řetězec obsahující volitelný seznam adres serverů.Tyto adresy mohou obejít pomocí přístupu k serveru proxy.Pokud NULL zadána hodnota, bude číst seznam vynechaných serverů z registru.Tento parametr má význam pouze v případě dwAccessType je nastavena na INTERNET_OPEN_TYPE_PROXY .

  • dwFlags
    Označuje různé možnosti ukládání do mezipaměti.Výchozí hodnota je nastavena na 0.Možné hodnoty:

    • INTERNET_FLAG_DONT_CACHEData, mezipaměti místně nebo všechny servery brány.

    • INTERNET_FLAG_OFFLINEPři stahování jsou plněny prostřednictvím trvalé mezipaměti.Pokud položka mezipaměti neexistuje, je vrácena k chybě.Tento příznak může být kombinován se bitového OR ()|) operátor.

Poznámky

CInternetSession je první Internet funkce volání aplikací.Při inicializaci vnitřních datových struktur a připraví na budoucí volání z aplikace.

Pokud lze otevřít žádné připojení k Internetu, CInternetSession vyvolá AfxThrowInternetException.

Příklad

Příklad pro CFtpFileFind.

Požadavky

Záhlaví: afxinet.h

Viz také

Referenční dokumentace

Třída CInternetSession

Graf hierarchie

CInternetSession::Close

CInternetSession::EnableStatusCallback

CInternetSession::GetContext