Função FindNextUrlCacheEntryW (wininet.h)

  • Artigo

Recupera a próxima entrada no cache da Internet.

Sintaxe

BOOL FindNextUrlCacheEntryW(
  [in]      HANDLE                       hEnumHandle,
  [out]     LPINTERNET_CACHE_ENTRY_INFOW lpNextCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parâmetros

[in] hEnumHandle

Manipule para a enumeração obtida de uma chamada anterior para FindFirstUrlCacheEntry.

[out] lpNextCacheEntryInfo

Ponteiro para uma estrutura INTERNET_CACHE_ENTRY_INFO que recebe informações sobre a entrada de cache.

[in, out] lpcbCacheEntryInfo

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

Retornar valor

Retorna TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
ERROR_INSUFFICIENT_BUFFER
 O tamanho de lpNextCacheEntryInfo conforme especificado por lpdwNextCacheEntryInfoBufferSize não é suficiente para conter todas as informações. O valor retornado em lpdwNextCacheEntryInfoBufferSize indica o tamanho do buffer necessário para conter todas as informações.
ERROR_NO_MORE_ITEMS
 A enumeração foi concluída.

Comentários

Continue a chamar FindNextUrlCacheEntry até que o último item no cache seja retornado.

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

Confira também

Cache

Funções WinINet