estructura INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Artículo
03/04/2024

Contiene información sobre una entrada de 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é permanente que está exenta de scavenging durante la cantidad de tiempo especificada por dwExemptDelta. El valor predeterminado establecido por CommitUrlCacheEntryA y CommitUrlCacheEntryW es un día.
TRACK_OFFLINE_CACHE_ENTRY	No implementado actualmente.
TRACK_ONLINE_CACHE_ENTRY	No implementado actualmente.

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 visitados.

dwUseCount

Número actual de llamadores de 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 superior 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 a la que se ha accedido 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 lpHeaderInfo , 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 ha accedido, en segundos.

Comentarios

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

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wininet.h