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

Запускает отфильтрованное перечисление кэша Интернета.

Синтаксис

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

Параметры

[in] lpszUrlSearchPattern

Указатель на строку, содержащую шаблон имени источника для поиска. Этот параметр можно задать только для файла cookie:, "visited:" или NULL. Задайте для этого параметра значение cookie:, чтобы перечислить файлы cookie или "посетил:", чтобы перечислить записи журнала URL-адресов в кэше. Если этот параметр имеет значение NULL, FindFirstUrlCacheEntryEx возвращает все записи содержимого в кэше.

[in] dwFlags

Управляет перечислением. В настоящее время флаги не реализуются; этот параметр должен иметь значение нулю.

[in] dwFilter

Битовая маска, указывающая тип записи кэша и его свойства. Типы записей кэша: записи журнала (URLHISTORY_CACHE_ENTRY), записи cookie (COOKIE_CACHE_ENTRY) и обычное кэшированное содержимое (NORMAL_CACHE_ENTRY).

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

[in] GroupId

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

[out] lpFirstCacheEntryInfo

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

[in, out] lpcbCacheEntryInfo

Указатель на переменную, указывающую размер структуры, на которую ссылается параметр lpFirstCacheEntryInfo в байтах.

[out] lpGroupAttributes

Этот параметр зарезервирован и должен иметь значение NULL.

[in, out] lpcbGroupAttributes

Этот параметр зарезервирован и должен иметь значение NULL.

[in] lpReserved

Этот параметр зарезервирован и должен иметь значение NULL.

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

Возвращает допустимый дескриптор при успешном выполнении или значении NULL в противном случае. Чтобы получить определенные сведения об ошибке, вызовите GetLastError. Если функция не находит соответствующие файлы, GetLastError возвращает ERROR_NO_MORE_FILES.

Замечания

Дескриптор, возвращенный из FindFirstUrlCacheEntryEx, используется во всех последующих вызовах FindNextUrlCacheEntryEx. В конце перечисления приложение должно вызывать FindCloseUrlCache.

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

Требования

См. также

кэширование

функций WinINet