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

Статья
08/27/2023

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

Использует указатель Gopher и условия поиска для создания сеанса с сервером и поиска запрошенных документов, двоичных файлов, серверов индексов или деревьев каталогов.

Синтаксис

HINTERNET GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA lpFindData,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Параметры

[in] hConnect

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

[in] lpszLocator

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

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

[in] lpszSearchString

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

[out] lpFindData

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

[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.

GopherFindFirstFile напоминает функцию FindFirstFile . Он создает соединение с сервером Gopher, а затем возвращает единую структуру, содержащую сведения о первом объекте Gopher, на который ссылается строка указателя.

После вызова GopherFindFirstFile для получения первого объекта Gopher в перечислении приложение может использовать функцию InternetFindNextFile для получения последующих объектов Gopher.

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

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

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

Примечание

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

Требования


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

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

Функции WinINet

Share via