Compartilhar via

Função FindFirstUrlCacheEntryExA (wininet.h)

  • Artigo

Inicia uma enumeração filtrada do cache da Internet.

Sintaxe

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

Parâmetros

[in] lpszUrlSearchPattern

Um ponteiro para uma cadeia de caracteres que contém o padrão de nome de origem a ser pesquisado. Esse parâmetro só pode ser definido como "cookie:", "visited:" ou NULL. Defina esse parâmetro como "cookie:" para enumerar os cookies ou "visitados:" para enumerar as entradas de Histórico de URL no cache. Se esse parâmetro for NULL, FindFirstUrlCacheEntryEx retornará todas as entradas de conteúdo no cache.

[in] dwFlags

Controla a enumeração. Nenhum sinalizador está implementado no momento; esse parâmetro deve ser definido como zero.

[in] dwFilter

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 parâmetro pode ser zero ou mais dos sinalizadores de propriedade a seguir e sinalizadores de tipo de cache listados abaixo.

Valor Significado
COOKIE_CACHE_ENTRY
 Entrada de cache de cookie.
EDITED_CACHE_ENTRY
 Arquivo de entrada de cache que foi editado externamente. Esse tipo de entrada de cache é isento de limpeza.
NORMAL_CACHE_ENTRY
 Entrada de cache normal; pode ser excluído para recuperar espaço para novas entradas.
SPARSE_CACHE_ENTRY
 Entrada de cache de resposta parcial.
STICKY_CACHE_ENTRY
 Entrada de cache autoadesiva; isento de limpeza.
TRACK_OFFLINE_CACHE_ENTRY
 Não implementado no momento.
TRACK_ONLINE_CACHE_ENTRY
 Não implementado no momento.
URLHISTORY_CACHE_ENTRY
 Entrada de cache de link visitada.

[in] GroupId

ID do grupo de cache a ser enumerado. Defina esse parâmetro como zero para enumerar todas as entradas que não estão agrupadas.

[out] lpFirstCacheEntryInfo

Ponteiro para uma estrutura de INTERNET_CACHE_ENTRY_INFO para receber as informações de entrada de cache.

[in, out] lpcbCacheEntryInfo

Ponteiro para variável que indica o tamanho da estrutura referenciada pelo parâmetro lpFirstCacheEntryInfo, em bytes.

[out] lpGroupAttributes

Esse parâmetro é reservado e deve ser NULL.

[in, out] lpcbGroupAttributes

Esse parâmetro é reservado e deve ser NULL.

[in] lpReserved

Esse parâmetro é reservado e deve ser NULL.

Valor de retorno

Retorna um identificador válido, se bem-sucedido ou NULL, caso contrário. Para obter informações de erro específicas, chame GetLastError. Se a função não encontrar arquivos correspondentes, GetLastError retornará ERROR_NO_MORE_FILES.

Observações

O identificador retornado de FindFirstUrlCacheEntryEx é usado em todas as chamadas subsequentes para FindNextUrlCacheEntryEx. No final da enumeração, o aplicativo deve chamar FindCloseUrlCache.

Assim como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do DllMain ou dos construtores e destruidores de objetos globais.

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 FindFirstUrlCacheEntryEx 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]
da Plataforma de Destino Windows
cabeçalho wininet.h
biblioteca Wininet.lib
de DLL Wininet.dll

Consulte também

cache

do WinINet Functions