Функция FindFirstUrlCacheEntryA (wininet.h)
Начинает перечисление кэша Интернета.
Синтаксис
HANDLE FindFirstUrlCacheEntryA(
[in] LPCSTR lpszUrlSearchPattern,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo
);
Параметры
[in] lpszUrlSearchPattern
Указатель на строку, содержащую шаблон исходного имени для поиска. Для этого параметра можно задать только значение "cookie:", "visited:" или NULL. Задайте для этого параметра значение cookie: для перечисления файлов cookie или "посещено", чтобы перечислить записи журнала URL-адресов в кэше. Если этот параметр имеет значение NULL, FindFirstUrlCacheEntry возвращает все записи содержимого в кэше.
[out] lpFirstCacheEntryInfo
Указатель на структуру INTERNET_CACHE_ENTRY_INFO .
[in, out] lpcbCacheEntryInfo
Указатель на переменную, указывающую размер буфера lpFirstCacheEntryInfo в байтах. При возврате функции переменная содержит количество байтов, скопированных в буфер, или необходимый размер, необходимый для получения записи кэша, в байтах.
Возвращаемое значение
Возвращает дескриптор, который приложение может использовать в функции FindNextUrlCacheEntry для получения последующих записей в кэше. Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
ERROR_INSUFFICIENT_BUFFER указывает, что размера lpFirstCacheEntryInfo , указанного в lpdwFirstCacheEntryInfoBufferSize , недостаточно для того, чтобы содержать всю информацию. Значение, возвращаемое в lpdwFirstCacheEntryInfoBufferSize , указывает размер буфера, необходимый для хранения всей информации.
Комментарии
Дескриптор, возвращаемый из FindFirstUrlCacheEntry , используется во всех последующих вызовах FindNextUrlCacheEntry. В конце перечисления приложение должно вызвать FindCloseUrlCache.
FindFirstUrlCacheEntry и FindNextUrlCacheEntry возвращают сведения о размере переменной. Если возвращается ERROR_INSUFFICIENT_BUFFER, приложение должно выделить буфер размера, указанного в lpdwFirstCacheEntryInfoBufferSize. Дополнительные сведения см. в разделе Использование буферов.
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.
Примечание
Заголовок wininet.h определяет FindFirstUrlCacheEntry в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |