структура INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Статья
11/20/2024

Содержит сведения о записи в кэше Интернета.

Синтаксис

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

Члены

dwStructSize

Размер этой структуры в байтах. Это значение можно использовать для определения версии системы кэша.

lpszSourceUrlName

Указатель на строку, завершающую значение NULL, содержащую имя URL-адреса. Строка занимает область памяти в конце этой структуры.

lpszLocalFileName

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

CacheEntryType

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

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

Ценность	Значение
EDITED_CACHE_ENTRY	Файл записи кэша, который был изменен внешним образом. Этот тип записи кэша исключается из очистки.
SPARSE_CACHE_ENTRY	Запись кэша частичных ответов.
STICKY_CACHE_ENTRY	Запись липкого кэша, которая освобождается от очистки в течение времени, указанного dwExemptDelta. Значение по умолчанию, заданное CommitUrlCacheEntryA и CommitUrlCacheEntryW составляет один день.
TRACK_OFFLINE_CACHE_ENTRY	В настоящее время не реализовано.
TRACK_ONLINE_CACHE_ENTRY	В настоящее время не реализовано.

В следующем списке содержатся флаги типа кэша.

Ценность	Значение
COOKIE_CACHE_ENTRY	Запись кэша файлов cookie.
NORMAL_CACHE_ENTRY	Обычная запись кэша; можно удалить, чтобы восстановить пространство для новых записей.
URLHISTORY_CACHE_ENTRY	Запись кэша посещаемых ссылок.

dwUseCount

Текущее число вызывающих объектов WinINEet с помощью записи кэша.

dwHitRate

Количество попыток получения записи кэша.

dwSizeLow

Низкая часть размера файла в байтах.

dwSizeHigh

Высокая часть размера файла в байтах.

LastModifiedTime

структура FILETIME, содержащая последнее измененное время этого URL-адреса в среднем формате времени Greenwich.

ExpireTime

структура FILETIME, которая содержит время окончания срока действия этого файла в среднем формате времени Greenwich.

LastAccessTime

структуре FILETIME, содержащей время последнего доступа, в среднем формате времени Greenwich.

LastSyncTime

структура FILETIME, содержащая последний раз синхронизации кэша.

lpHeaderInfo

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

dwHeaderInfoSize

Размер буфера lpHeaderInfo в TCHARs.

lpszFileExtension

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

dwReserved

dwExemptDelta

Время исключения из времени последнего доступа в секундах.

Замечания

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

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

Заметка

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

Требования

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