estrutura INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Artigo
11/20/2024

Contém informações sobre uma entrada no cache da 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 no momento.
TRACK_ONLINE_CACHE_ENTRY	Não implementado no momento.

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ído para recuperar espaço para novas entradas.
URLHISTORY_CACHE_ENTRY	Entrada de cache de link visitada.

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 tempo médio de Greenwich.

ExpireTime

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

LastAccessTime

estrutura FILETIME que contém a hora acessada pela última vez, no formato de tempo médio 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 do cabeçalho. O buffer ocupa a memória no final dessa estrutura.

dwHeaderInfoSize

Tamanho do buffer de 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.

Observações

Não há nenhum 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.

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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