CInternetSession::OpenURL
Эта функция-член вызывается отправить указанный запрос к HTTP-серверу и разрешить клиента для указания дополнительного RFC822, MIME или отправлять заголовок HTTP вместе с запросом.
CStdioFile* OpenURL(
LPCTSTR pstrURL,
DWORD_PTR dwContext = 1,
DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
LPCTSTR pstrHeaders = NULL,
DWORD dwHeadersLength = 0
);
Параметры
pstrURL
Указатель на имя url-адреса, с которого начинается чтение. Только url-адреса, начиная с file:, ftp:, gopher: или http: поддерживается. ASSERTS если pszURLNULL.dwContext
Приложение- указанное значение, передаваемое с возвращенным токеном в обратном вызове.dwFlags
Флаги, описывающие, как обрабатывать это соединение. См. раздел Примечания дополнительные сведения о допустимых флагах. Допустимые флаги:INTERNET_FLAG_TRANSFER_ASCII Значение по умолчанию. Откройте файл как текст ASCII.
Переключение INTERNET_FLAG_TRANSFER_BINARY файл как двоичный файл.
INTERNET_FLAG_RELOAD получает данные из подключения, даже если его локально кэширует.
INTERNET_FLAG_DONT_CACHE не кэширует данные или локально или в любых шлюзах.
Этот INTERNET_FLAG_SECURE пометить применимо только к HTTP-запроса. Он запрашивает безопасных транзакций в сети с использованием протокола SSL или протокол PCT.
INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT Если возможно, повторно использует существующие соединения к серверу для новых запросов, создаваемых OpenUrl вместо создания нового сеанса для каждого запроса соединения.
INTERNET_FLAG_PASSIVE, Используемый для веб-сайта FTP. Использовать пассивную семантику FTP. Используемый с CInternetConnectionOpenURL.
pstrHeaders
Указатель на строку, содержащую заголовки, которые должны быть переданы на сервер HTTP.dwHeadersLength
Длина в единицах символов дополнительных заголовков. Если это -1L и pstrHeaders подписчиков, отличных от NULL, он считается завершенным pstrHeaders нулю и длина вычисляется.
Возвращаемое значение
Возвращает дескриптор файла для FTP GOPHER, HTTP и служб интернета типа файла. Возвращает NULL если анализ был неудачн.
Указатель на OpenURL возвращает тип pszURL зависит от службы. В следующей таблице показаны возможные указатели OpenURL может возвратить.
Тип URL |
Возвращаемые значения |
|---|---|
file:// |
CStdioFile* |
http:// |
CHttpFile* |
gopher:// |
CGopherFile* |
ftp:// |
CInternetFile* |
Заметки
Параметр dwFlags должен включать или INTERNET_FLAG_TRANSFER_ASCII или INTERNET_FLAG_TRANSFER_BINARY, но не оба. Остальные флаги могут быть объединены с OR (побитовый оператор |).
OpenURL, которая создает программу-оболочку Win32, функция InternetOpenURL допускает только загрузить, получение и чтение данных с сервера через интернет. Нет OpenURL не позволяет управлять файла на дистанционном месте, поэтому он не требует объекта CInternetConnection.
Для использования функций подключение- (то есть протокол-), определенного как запись в файл, необходимо открыть сеанс, а затем открыть конкретный тип соединения, а затем использовать то соединение открыть файл в нужному режиме. См. раздел CInternetConnection дополнительные сведения о конкретных функциях подключение-.
Исключения
Этот метод может создавать исключения типа CInternetException*.
Требования
Header: afxinet.h