Функция GopherFindFirstFileW (wininet.h)
[Функция GopherFindFirstFile доступна для использования в операционных системах, указанных в разделе Требования.]
Использует указатель Gopher и условия поиска для создания сеанса с сервером и поиска запрошенных документов, двоичных файлов, серверов индексов или деревьев каталогов.
Синтаксис
HINTERNET GopherFindFirstFileW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszLocator,
[in] LPCWSTR lpszSearchString,
[out] LPGOPHER_FIND_DATAW lpFindData,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Параметры
[in] hConnect
Дескриптор сеанса Gopher, возвращаемого InternetConnect.
[in] lpszLocator
Указатель на строку, завершающуюся нулевым значением, которая содержит имя искать элемент. Оно может быть одним из следующих.
- Указатель gopher, возвращенный предыдущим вызовом этой функции или функции InternetFindNextFile .
- Указатель NULL или пустая строка, указывающая, что возвращается самая верхняя информация с сервера Gopher.
- Указатель, созданный функцией GopherCreateLocator .
[in] lpszSearchString
Указатель на буфер, содержащий строки для поиска, если этот запрос выполняется на сервер индексирования. В противном случае этот параметр должен иметь значение NULL.
[out] lpFindData
Указатель на структуру GOPHER_FIND_DATA , которая получает сведения, полученные этой функцией.
[in] dwFlags
Управляет поведением функции. Этот параметр может быть сочетанием следующих значений.
| Значение | Значение |
|---|---|
|
При определении того, следует ли перезагружать элемент из сети, принудительно выполняется перезагрузка, если не было возвращено время окончания срока действия и время последнего изменения с сервера. |
|
Вызывает создание временного файла, если файл не может быть кэширован. |
|
Не добавляет возвращенную сущность в кэш. |
|
Принудительное скачивание запрошенного файла, объекта или списка каталогов с сервера-источника, а не из кэша. |
|
Перезагружает ресурсы HTTP, если ресурс был изменен с момента последнего скачивания. Все ресурсы FTP и Gopher перезагружаются. |
[in] dwContext
Указатель на переменную, содержащую определяемое приложением значение, которое связывает этот поиск с любыми данными приложения.
Возвращаемое значение
Возвращает допустимый дескриптор поиска в случае успешного выполнения или значение NULL в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError или InternetGetLastResponseInfo.
Комментарии
GopherFindFirstFile очень похож на функцию FindFirstFile . Он создает соединение с сервером Gopher, а затем возвращает единую структуру, содержащую сведения о первом объекте Gopher, на который ссылается строка указателя.
После вызова GopherFindFirstFile для получения первого объекта Gopher в перечислении приложение может использовать функцию InternetFindNextFile для получения последующих объектов Gopher.
После завершения работы вызывающего приложения с дескриптором HINTERNET , возвращенным GopherFindFirstFile, его необходимо закрыть с помощью функции InternetCloseHandle .
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.
Примечание
Заголовок wininet.h определяет GopherFindFirstFile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |