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

Статья
11/20/2024

Извлекает следующую запись в кэше Интернета.

Синтаксис

BOOL FindNextUrlCacheEntryA(
  [in]      HANDLE                       hEnumHandle,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Параметры

[in] hEnumHandle

Обработка перечисления, полученного из предыдущего вызова FindFirstUrlCacheEntry.

[out] lpNextCacheEntryInfo

Указатель на структуру INTERNET_CACHE_ENTRY_INFO, которая получает сведения о записи кэша.

[in, out] lpcbCacheEntryInfo

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

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

Возвращает TRUE, если выполнено успешно или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. Возможные значения ошибок включают следующие значения.

Возвращаемый код	Описание
ERROR_INSUFFICIENT_BUFFER	Размер lpNextCacheEntryInfo, указанный lpdwNextCacheEntryInfoBufferSize недостаточно для хранения всех сведений. Значение, возвращаемое в lpdwNextCacheEntryInfoBufferSize указывает размер буфера, необходимый для хранения всех сведений.
ERROR_NO_MORE_ITEMS	Перечисление завершено.

Замечания

Продолжайте вызывать FindNextUrlCacheEntry, пока не будет возвращен последний элемент в кэше.

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

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

Заметка

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

Требования

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

См. также

кэширование

функций WinINet

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