estructura INTERNET_CACHE_ENTRY_INFOW (wininet.h)

Artículo
08/27/2023

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

Sintaxis

typedef struct _INTERNET_CACHE_ENTRY_INFOW {
  DWORD    dwStructSize;
  LPWSTR   lpszSourceUrlName;
  LPWSTR   lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPWSTR   lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPWSTR   lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOW, *LPINTERNET_CACHE_ENTRY_INFOW;

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 siguientes marcas de propiedad 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 del 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	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 autores de llamadas 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 última hora a la que se ha accedido, 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 de acceso, 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 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 los 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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