Udostępnij za pośrednictwem


CInternetSession::OpenURL

Wywołanie tego członka, funkcji, aby wysłać określone żądanie do serwera HTTP i Zezwalaj na klienta określić dodatkowe RFC822 MIME lub nagłówki HTTP do wysłania wraz z żądaniem.

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

Parametry

  • pstrURL
    Wskaźnik nazwę adresu URL, aby rozpocząć czytanie.Tylko adresy URL zaczynając od pliku:, ftp:, gopher:, lub http: są obsługiwane.ZARZĄZANIE Jeśli pszURL jest NULL.

  • dwContext
    Wartość przez aplikację przekazywane z zwracany uchwyt w wywołania zwrotnego.

  • dwFlags
    Flagi opisujące sposób obsługi tego połączenia.Zobacz uwagi uzyskać więcej informacji o prawidłowe flagi.Prawidłowe flagi są:

    • INTERNET_FLAG_TRANSFER_ASCII domyślnie.Transfer pliku jako tekst ASCII.

    • INTERNET_FLAG_TRANSFER_BINARY transferu pliku jako pliku binarnego.

    • INTERNET_FLAG_RELOADUzyskać danych z drutu, nawet jeśli jest lokalnie buforowane.

    • INTERNET_FLAG_DONT_CACHENie buforuj danych, lokalnie lub bram.

    • INTERNET_FLAG_SECUREFlaga ta dotyczy tylko żądania HTTP.Żądania bezpiecznych transakcji na drutu z Secure Sockets Layer lub procentu

    • INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT , jeśli to możliwe, ponowne używanie istniejących połączeń z serwerem nowych żądań wygenerowanych przez OpenUrl zamiast tworzenia nowej sesji dla każdego żądania połączenia.

    • INTERNET_FLAG_PASSIVE używany dla witryny FTP.Używa semantykę pasywnego FTP.Używane z CInternetConnection z OpenURL.

  • pstrHeaders
    Wskaźnik ciąg zawierający nagłówki przesyłany do serwera HTTP.

  • dwHeadersLength
    Długość w znakach dodatkowych nagłówków.Jeśli-1 L i pstrHeaders jest non-NULL, następnie pstrHeaders przyjmuje się zero zakończone i długość jest obliczana.

Wartość zwracana

Zwraca uchwyt pliku tylko usług FTP, GOPHER, HTTP i Internet typu pliku.Zwraca NULL Jeśli analizy nie powiodło się.

Wskaźnik, OpenURL zależy od zwraca pszURLprzez typ usługi.Poniższa tabela przedstawia możliwe wskaźniki OpenURL można powrócić.

Typ adresu URL

Zwraca

File://

CStdioFile *

http://

CHttpFile *

Gopher://

CGopherFile *

FTP: / /

CInternetFile *

Uwagi

Parametr dwFlags musi zawierać albo INTERNET_FLAG_TRANSFER_ASCII lub INTERNET_FLAG_TRANSFER_BINARY, ale nie obu.Pozostałe flagi można łączyć z bitowym OR operator (|).

OpenURL, który otacza funkcji Win32 InternetOpenURL, umożliwia tylko pobieranie, pobieranie i odczytu danych z serwera internetowego.OpenURLUmożliwia manipulacji nie pliku w lokalizacji zdalnej, więc nie wymaga CInternetConnection obiektu.

Aby użyć połączenia (czyli protokole) funkcje, jak zapis do pliku, użytkownik musi otworzyć sesję, następnie otworzyć określonego rodzaju połączenia, a następnie użyć do otwarcia pliku w trybie żądane połączenie.Zobacz CInternetConnection Aby uzyskać więcej informacji o funkcjach specyficznych dla połączenia.

Wyjątki

Tej metody można zgłosić wyjątków typu CInternetException*.

Wymagania

Nagłówek: afxinet.h

Zobacz też

Informacje

Klasa CInternetSession

Wykres hierarchii

Klasa CInternetConnection

Klasa CGopherConnection

CInternetSession::GetFtpConnection

CInternetSession::GetHttpConnection