Sdílet prostřednictvím


CInternetSession::OpenURL

Tento člen volání funkce Odeslat zadaný požadavek HTTP serveru a umožňují určit další RFC822 klientu MIME nebo odeslat požadavek s záhlaví HTTP.

CStdioFile* OpenURL( 
   LPCTSTR pstrURL, 
   DWORD_PTR dwContext = 1, 
   DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII, 
   LPCTSTR pstrHeaders = NULL, 
   DWORD dwHeadersLength = 0  
);

Parametry

  • pstrURL
    Ukazatel myši na název URL zahájit čtení.Pouze adresy URL začínající souboru:, ftp:, gopher:, nebo http: jsou podporovány.ASSERTS -li pszURL je NULL.

  • dwContext
    Hodnotu definované aplikací předán popisovačem vrácené ve zpětném volání.

  • dwFlags
    Příznaky popisující způsob zpracování tohoto připojení.Viz poznámky Další informace o platné příznaky.Platné příznaky jsou:

    • INTERNET_FLAG_TRANSFER_ASCII výchozí.Přenos souboru jako ASCII text.

    • INTERNET_FLAG_TRANSFER_BINARY přenos souboru jako binární soubor.

    • INTERNET_FLAG_RELOADZískáte data z lince i místní mezipaměti.

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

    • INTERNET_FLAG_SECURETento příznak je použitelná pouze pro požadavky HTTP.Požaduje zabezpečené transakce na lince s protokol SSL (Secure Sockets Layer) nebo protokol PCT.

    • INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT pokud možno znovu použít existující připojení k serveru pro nové požadavky generované OpenUrl vytvářet novou relaci pro každý požadavek na připojení.

    • INTERNET_FLAG_PASSIVE pro server FTP.Pasivní sémantiku FTP používá.S CInternetConnection z OpenURL .

  • pstrHeaders
    Ukazatel na řetězec obsahující záhlaví k odeslání na server HTTP.

  • dwHeadersLength
    Délka znaky další záhlaví.Pokud L-1 a pstrHeaders je non-NULL, pak pstrHeaders považován za nulové ukončena a délka počítá.

Vrácená hodnota

Vrátí popisovač souboru pro FTP, GOPHER, HTTP a typ souboru Internet services.Vrátí NULL Pokud analýza neúspěšná.

Ukazatel, OpenURL vrátí závisí na pszURLdaného typu služby.Následující tabulka ukazuje možné ukazatele OpenURL vrátit.

Typ URL

Výsledek

file://

CStdioFile *

http://

CHttpFile *

Gopher://

CGopherFile *

ftp://

CInternetFile *

Poznámky

Parametr dwFlags musí obsahovat INTERNET_FLAG_TRANSFER_ASCII nebo INTERNET_FLAG_TRANSFER_BINARY, ale ne obojí.Zbývající příznaky lze kombinovat s bitového OR () operátor**|**).

OpenURL, který obtéká funkci Win32 InternetOpenURL, umožňuje pouze stahování, načítání a načtení dat ze serveru sítě Internet.OpenURLumožňuje manipulaci žádný soubor na vzdáleném místě, takže vyžaduje č CInternetConnection objektu.

Použití specifických pro připojení (, protokol) funkce, například zápis do souboru, můžete musí otevřít relaci, otevřete konkrétní druh připojení a pak použít připojení k otevření souboru v požadovaném režimu.Viz CInternetConnection Další informace o funkce specifické pro připojení.

Výjimky

Tuto metodu lze vyvolávají výjimky typu CInternetException* .

Požadavky

Záhlaví: afxinet.h

Viz také

Referenční dokumentace

Třída CInternetSession

Graf hierarchie

Třída CInternetConnection

Třída CGopherConnection

CInternetSession::GetFtpConnection

CInternetSession::GetHttpConnection