Função FindNextUrlCacheEntryA (wininet.h)

Artigo
11/20/2024

Recupera a próxima entrada no cache da Internet.

Sintaxe

BOOL FindNextUrlCacheEntryA(
  [in]      HANDLE                       hEnumHandle,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA 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 de 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.

Valor de retorno

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.

Observações

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

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

Compartilhar via