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

Статья
11/20/2024

[Функция 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-terminated, указывающую открытый файл. Как правило, этот указатель возвращается из вызова GopherFindFirstFile или InternetFindNextFile. Так как протокол Gopher не имеет концепции текущего каталога, указатель всегда является полным.

[in] lpszView

Указатель на строку null-terminated, описывающую представление, которое нужно открыть, если на сервере существует несколько представлений файла. Если lpszViewNULL, функция использует представление файлов по умолчанию.

[in] dwFlags

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

Ценность	Значение
INTERNET_FLAG_HYPERLINK	Принудивает перезагрузку, если срок действия истекает, и время LastModified не возвращается с сервера при определении необходимости перезагрузки элемента из сети.
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 Services (WinHTTP).

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

Функции WinINet

Поделиться через