Compartilhar via


Função FindFirstUrlCacheEntryA (wininet.h)

Inicia a enumeração do cache da Internet.

Sintaxe

HANDLE FindFirstUrlCacheEntryA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

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, FindFirstUrlCacheEntry retornará todas as entradas de conteúdo no cache.

[out] lpFirstCacheEntryInfo

Ponteiro para uma estrutura de INTERNET_CACHE_ENTRY_INFO .

[in, out] lpcbCacheEntryInfo

Ponteiro para uma variável que especifica o tamanho do buffer lpFirstCacheEntryInfo , em bytes. Quando a função retorna, a variável contém o número de bytes copiados para o buffer ou o tamanho necessário necessário para recuperar a entrada de cache, em bytes.

Valor retornado

Retorna um identificador que o aplicativo pode usar na função FindNextUrlCacheEntry para recuperar entradas subsequentes no cache. Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

ERROR_INSUFFICIENT_BUFFER indica que o tamanho de lpFirstCacheEntryInfo conforme especificado por lpdwFirstCacheEntryInfoBufferSize não é suficiente para conter todas as informações. O valor retornado em lpdwFirstCacheEntryInfoBufferSize indica o tamanho do buffer necessário para conter todas as informações.

Comentários

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

FindFirstUrlCacheEntry e FindNextUrlCacheEntry retornam informações de tamanho de variável. Se ERROR_INSUFFICIENT_BUFFER for retornado, o aplicativo deverá alocar um buffer do tamanho especificado por lpdwFirstCacheEntryInfoBufferSize. Para obter mais informações, consulte Usando buffers.

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