Função GetUrlCacheEntryInfoW (wininet.h)

  • Artigo

Recupera informações sobre uma entrada de cache.

Sintaxe

BOOL GetUrlCacheEntryInfoW(
  [in]      LPCWSTR                      lpszUrlName,
  [out]     LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parâmetros

[in] lpszUrlName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da entrada de cache. A cadeia de caracteres de nome não deve conter nenhum caractere de escape.

[out] lpCacheEntryInfo

Um ponteiro para uma estrutura INTERNET_CACHE_ENTRY_INFO que recebe informações sobre a entrada de cache. Um buffer deve ser alocado para esse parâmetro.

Como o tamanho necessário do buffer não é conhecido com antecedência, é melhor alocar um buffer adequado para lidar com o tamanho da maioria das entradas INTERNET_CACHE_ENTRY_INFO . Não há limite de tamanho de entrada de cache, portanto, os aplicativos que precisam enumerar o cache devem estar preparados para alocar buffers de tamanho variável.

[in, out] lpcbCacheEntryInfo

Um ponteiro para uma variável que especifica o tamanho do buffer lpCacheEntryInfo , 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 do buffer, em bytes.

Retornar valor

Retornará 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_FILE_NOT_FOUND
 A entrada de cache especificada não foi encontrada no cache.
ERROR_INSUFFICIENT_BUFFER
 O tamanho de lpCacheEntryInfo conforme especificado por lpdwCacheEntryInfoBufferSize não é suficiente para conter todas as informações. O valor retornado em lpdwCacheEntryInfoBufferSize indica o tamanho do buffer necessário para conter todas as informações.

Comentários

GetUrlCacheEntryInfo não faz nenhuma análise de URL, portanto, uma URL que contém uma âncora (#) não será encontrada no cache, mesmo que o recurso seja armazenado em cache. Por exemplo, se a URL http://example.com/example.htm#sample for passada, a função retornará ERROR_FILE_NOT_FOUND mesmo que http://example.com/example.htm esteja no cache.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de 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 de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define GetUrlCacheEntryInfo 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