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 "visited:" 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 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ída para recuperar espaço para novas entradas.
SPARSE_CACHE_ENTRY
 Entrada de cache de resposta parcial.
STICKY_CACHE_ENTRY
 Entrada de cache persistente; isenta de limpeza.
TRACK_OFFLINE_CACHE_ENTRY
 Não implementado atualmente.
TRACK_ONLINE_CACHE_ENTRY
 Não implementado atualmente.
URLHISTORY_CACHE_ENTRY
 Entrada de cache de link visitado.

[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 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 retornado

Retorna um identificador válido se tiver êxito ou NULL de outra forma. 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.

Comentários

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

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.

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

Observação

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

   
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]
Plataforma de Destino Windows
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Cache

Funções WinINet