Функция GopherOpenFileA (wininet.h)

  • Статья

[Функция GopherOpenFile доступна для использования в операционных системах, указанных в разделе "Требования".]

Начинает чтение файла данных Gopher с сервера Gopher.

Синтаксис

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Параметры

[in] hConnect

Обработка сеанса Gopher, возвращаемого InternetConnect.

[in] lpszLocator

Указатель на строку, завершающуюся значением NULL, которая указывает файл, который необходимо открыть. Как правило, этот указатель возвращается при вызове GopherFindFirstFile или InternetFindNextFile. Так как протокол Gopher не имеет понятия о текущем каталоге, указатель всегда является полным.

[in] lpszView

Указатель на строку, завершающуюся значением NULL, которая описывает представление, которое необходимо открыть, если на сервере существует несколько представлений файла. Если lpszView имеет значение NULL, функция использует представление файла по умолчанию.

[in] dwFlags

Условия, при которых происходят последующие передачи. Этот параметр может быть любым из следующих значений.

Значение Значение
INTERNET_FLAG_HYPERLINK
 При определении того, следует ли перезагрузить элемент из сети, принудительно выполняется перезагрузка, если не было возвращено время истечения срока действия и время последнегоmodified, возвращенное сервером.
INTERNET_FLAG_NEED_FILE
 Вызывает создание временного файла, если файл не может быть кэширован.
INTERNET_FLAG_NO_CACHE_WRITE
 Не добавляет возвращенную сущность в кэш.
INTERNET_FLAG_RELOAD
 Принудительное скачивание запрошенного файла, объекта или списка каталога с исходного сервера, а не из кэша.
INTERNET_FLAG_RESYNCHRONIZE
 Перезагружает http-ресурсы, если ресурс был изменен с момента последнего скачивания. Все ресурсы FTP и Gopher перезагружаются.

[in] dwContext

Указатель на переменную, содержащую определяемое приложением значение, которое связывает эту операцию с любыми данными приложения.

Возвращаемое значение

Возвращает дескриптор в случае успешного выполнения или значение NULL , если файл не удается открыть. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError или InternetGetLastResponseInfo.

Комментарии

GopherOpenFile открывает файл на сервере Gopher. Так как файл фактически не может быть открыт или заблокирован на сервере, эта функция просто связывает сведения о расположении с дескриптором, который приложение может использовать для файловых операций, таких как InternetReadFile или GopherGetAttribute.

После завершения работы вызывающего приложения с помощью дескриптора HINTERNET , возвращаемого GopherOpenFile, его необходимо закрыть с помощью функции InternetCloseHandle .

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Примечание

Заголовок wininet.h определяет GopherOpenFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Функции WinINet