estrutura INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Artigo
08/27/2023

Contém informações sobre uma entrada no cache de Internet.

Sintaxe

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;

Membros

dwStructSize

Tamanho dessa estrutura, em bytes. Esse valor pode ser usado para ajudar a determinar a versão do sistema de cache.

lpszSourceUrlName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da URL. A cadeia de caracteres ocupa a área de memória no final dessa estrutura.

lpszLocalFileName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo local. A cadeia de caracteres ocupa a área de memória no final dessa estrutura.

CacheEntryType

Uma máscara de bits que indica o tipo de entrada de cache e suas propriedades. Os tipos de entrada de cache incluem: entradas de histórico (URLHISTORY_CACHE_ENTRY), entradas de cookie (COOKIE_CACHE_ENTRY) e conteúdo armazenado em cache normal (NORMAL_CACHE_ENTRY).

Esse membro pode ser zero ou mais dos sinalizadores de propriedade a seguir e sinalizadores de tipo de cache listados abaixo.

Valor	Significado
EDITED_CACHE_ENTRY	Arquivo de entrada de cache que foi editado externamente. Esse tipo de entrada de cache é isento de limpeza.
SPARSE_CACHE_ENTRY	Entrada de cache de resposta parcial.
STICKY_CACHE_ENTRY	Entrada de cache autoadesiva isenta de limpeza pela quantidade de tempo especificada por dwExemptDelta. O valor padrão definido por CommitUrlCacheEntryA e CommitUrlCacheEntryW é um dia.
TRACK_OFFLINE_CACHE_ENTRY	Não implementado atualmente.
TRACK_ONLINE_CACHE_ENTRY	Não implementado atualmente.

A lista a seguir contém os sinalizadores de tipo de cache.

Valor	Significado
COOKIE_CACHE_ENTRY	Entrada de cache de cookie.
NORMAL_CACHE_ENTRY	Entrada de cache normal; pode ser excluída para recuperar espaço para novas entradas.
URLHISTORY_CACHE_ENTRY	Entrada de cache de link visitado.

dwUseCount

Número atual de chamadores WinINEet usando a entrada de cache.

dwHitRate

Número de vezes que a entrada de cache foi recuperada.

dwSizeLow

Parte de baixa ordem do tamanho do arquivo, em bytes.

dwSizeHigh

Parte de alta ordem do tamanho do arquivo, em bytes.

LastModifiedTime

Estrutura FILETIME que contém a hora da última modificação dessa URL, no formato de horário de Greenwich.

ExpireTime

Estrutura FILETIME que contém a hora de expiração desse arquivo, no formato de tempo médio de Greenwich.

LastAccessTime

Estrutura FILETIME que contém a hora do último acesso, no formato de horário de Greenwich.

LastSyncTime

Estrutura FILETIME que contém a última vez em que o cache foi sincronizado.

lpHeaderInfo

Ponteiro para um buffer que contém as informações de cabeçalho. O buffer ocupa a memória no final dessa estrutura.

dwHeaderInfoSize

Tamanho do buffer lpHeaderInfo , em TCHARs.

lpszFileExtension

Ponteiro para uma cadeia de caracteres que contém a extensão de nome de arquivo usada para recuperar os dados como um arquivo. A cadeia de caracteres ocupa a área de memória no final dessa estrutura.

dwReserved

dwExemptDelta

Tempo de isenção do último tempo acessado, em segundos.

Comentários

Não há limite de tamanho de entrada de cache, portanto, os aplicativos que precisam enumerar o cache devem estar preparados para alocar buffers de tamanho variável. Para obter mais informações, consulte Usando buffers.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

Observação

O cabeçalho wininet.h define INTERNET_CACHE_ENTRY_INFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	wininet.h