estructura INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Artículo
11/20/2024

Contiene información sobre una entrada en la caché de Internet.

Sintaxis

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;

Miembros

dwStructSize

Tamaño de esta estructura, en bytes. Este valor se puede usar para ayudar a determinar la versión del sistema de caché.

lpszSourceUrlName

Puntero a una cadena terminada en null que contiene el nombre de la dirección URL. La cadena ocupa el área de memoria al final de esta estructura.

lpszLocalFileName

Puntero a una cadena terminada en null que contiene el nombre de archivo local. La cadena ocupa el área de memoria al final de esta estructura.

CacheEntryType

Máscara de bits que indica el tipo de entrada de caché y sus propiedades. Los tipos de entrada de caché incluyen: entradas del historial (URLHISTORY_CACHE_ENTRY), entradas de cookies (COOKIE_CACHE_ENTRY) y contenido almacenado en caché normal (NORMAL_CACHE_ENTRY).

Este miembro puede ser cero o más de las marcas de propiedad siguientes y las marcas de tipo de caché que se enumeran a continuación.

Valor	Significado
EDITED_CACHE_ENTRY	Archivo de entrada de caché que se ha editado externamente. Este tipo de entrada de caché está exento del scavenging.
SPARSE_CACHE_ENTRY	Entrada de caché de respuesta parcial.
STICKY_CACHE_ENTRY	Entrada de caché pegajosa que está exenta de scavenging durante el período de tiempo especificado por dwExemptDelta. El valor predeterminado establecido por CommitUrlCacheEntryA y commitUrlCacheEntryW es un día.
TRACK_OFFLINE_CACHE_ENTRY	Actualmente no se ha implementado.
TRACK_ONLINE_CACHE_ENTRY	Actualmente no se ha implementado.

La lista siguiente contiene las marcas de tipo de caché.

Valor	Significado
COOKIE_CACHE_ENTRY	Entrada de caché de cookies.
NORMAL_CACHE_ENTRY	Entrada de caché normal; se puede eliminar para recuperar espacio para las nuevas entradas.
URLHISTORY_CACHE_ENTRY	Entrada de caché de vínculos visitada.

dwUseCount

Número actual de llamadores winINEet mediante la entrada de caché.

dwHitRate

Número de veces que se recuperó la entrada de caché.

dwSizeLow

Parte de orden bajo del tamaño del archivo, en bytes.

dwSizeHigh

Parte de orden alto del tamaño del archivo, en bytes.

LastModifiedTime

estructura FILETIME que contiene la hora de última modificación de esta dirección URL, en formato de hora media de Greenwich.

ExpireTime

estructura FILETIME que contiene la hora de expiración de este archivo, en formato de hora media de Greenwich.

LastAccessTime

ESTRUCTURA FILETIME que contiene la hora de acceso por última vez, en formato de hora media de Greenwich.

LastSyncTime

estructura FILETIME que contiene la última vez que se sincronizó la memoria caché.

lpHeaderInfo

Puntero a un búfer que contiene la información de encabezado. El búfer ocupa la memoria al final de esta estructura.

dwHeaderInfoSize

Tamaño del búfer de lpHeaderInfo de , en TCHAR.

lpszFileExtension

Puntero a una cadena que contiene la extensión de nombre de archivo utilizada para recuperar los datos como un archivo. La cadena ocupa el área de memoria al final de esta estructura.

dwReserved

dwExemptDelta

Tiempo de exención de la última hora a la que se accede, en segundos.

Observaciones

No hay ningún límite de tamaño de entrada de caché, por lo que las aplicaciones que necesitan enumerar la caché deben estar preparadas para asignar búferes de tamaño variable. Para obtener más información, consulte Using Buffers.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).

Nota

El encabezado wininet.h define INTERNET_CACHE_ENTRY_INFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	wininet.h