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