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

Статья
11/20/2024

[Функция 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-terminated, содержащую имя элемента для поиска. Это может быть одно из следующих вариантов:

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

[in] lpszSearchString

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

[out] lpFindData

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

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

Замечания

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

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

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

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

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

Заметка

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

Требования

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

См. также

функций WinINet

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