Compartilhar via

Função GetUrlCacheEntryInfoExA (wininet.h)

  • Artigo

Recupera informações sobre a entrada de cache associada à URL especificada, levando em conta todos os redirecionamentos aplicados no modo offline pela função HttpSendRequest.

Sintaxe

BOOL GetUrlCacheEntryInfoExA(
  [in]                LPCSTR                       lpszUrl,
  [in, out, optional] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in, out, optional] LPDWORD                      lpcbCacheEntryInfo,
  [out]               LPSTR                        lpszRedirectUrl,
  [in, out]           LPDWORD                      lpcbRedirectUrl,
                      LPVOID                       lpReserved,
  [in]                DWORD                        dwFlags
);

Parâmetros

[in] lpszUrl

Um ponteiro para um cadeia de caracteresterminada nula que contém o nome da entrada de cache. A cadeia de caracteres de nome não deve conter nenhum caractere de escape.

[in, out, optional] lpCacheEntryInfo

Um ponteiro para uma estrutura de 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á nenhum 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, optional] lpcbCacheEntryInfo

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.

[out] lpszRedirectUrl

Esse parâmetro é reservado e deve ser NULL.

[in, out] lpcbRedirectUrl

Esse parâmetro é reservado e deve ser NULL.

lpReserved

Esse parâmetro é reservado e deve ser NULL.

[in] dwFlags

Esse parâmetro é reservado e deve ser 0.

Valor de retorno

Retorna VERDADEIRO se a URL estiver localizada ou FALSE caso contrário. Chame GetLastError para obter informações de erro específicas. Os possíveis erros incluem o seguinte.

Código de retorno Descrição
ERROR_FILE_NOT_FOUND
 A URL não foi encontrada no índice de cache, mesmo depois de levar em conta os redirecionamentos armazenados em cache.
ERROR_INSUFFICIENT_BUFFER
 O buffer referenciado por lpCacheEntryInfo não era grande o suficiente para conter as informações solicitadas. O tamanho do buffer necessário será retornado para lpdwCacheEntryInfoBufSize.

Observações

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

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

Funções WinINet