Função GetUrlCacheEntryInfoExA (wininet.h)
Recupera informações sobre a entrada de cache associada à URL especificada, levando em conta quaisquer 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 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.
[in, out, optional] 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, 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.
Retornar valor
Retornará TRUE 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 |
|---|---|
|
A URL não foi encontrada no índice de cache, mesmo depois de levar em conta os redirecionamentos armazenados em cache. |
|
O buffer referenciado por lpCacheEntryInfo não era grande o suficiente para manter as informações solicitadas. O tamanho do buffer necessário será retornado para lpdwCacheEntryInfoBufSize. |
Comentários
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.
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.
Observação
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 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 |