Funzione GetUrlCacheEntryInfoExA (wininet.h)

  • Articolo

Recupera informazioni sulla voce della cache associata all'URL specificato, tenendo conto di eventuali reindirizzamenti applicati in modalità offline dalla funzione HttpSendRequest .

Sintassi

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
);

Parametri

[in] lpszUrl

Puntatore a una stringa con terminazione Null contenente il nome della voce della cache. La stringa del nome non deve contenere caratteri di escape.

[in, out, optional] lpCacheEntryInfo

Puntatore a una struttura di INTERNET_CACHE_ENTRY_INFO che riceve informazioni sulla voce della cache. Per questo parametro deve essere allocato un buffer.

Poiché le dimensioni necessarie del buffer non sono note in anticipo, è consigliabile allocare un buffer adeguato per gestire le dimensioni della maggior parte delle voci INTERNET_CACHE_ENTRY_INFO . Non esiste alcun limite per le dimensioni delle voci della cache, pertanto le applicazioni che devono enumerare la cache devono essere preparate per allocare buffer di dimensioni variabili.

[in, out, optional] lpcbCacheEntryInfo

Puntatore a una variabile che specifica le dimensioni del buffer lpCacheEntryInfo , in byte. Quando la funzione viene restituita, la variabile contiene il numero di byte copiati nel buffer o le dimensioni necessarie del buffer in byte.

[out] lpszRedirectUrl

Questo parametro è riservato e deve essere NULL.

[in, out] lpcbRedirectUrl

Questo parametro è riservato e deve essere NULL.

lpReserved

Questo parametro è riservato e deve essere NULL.

[in] dwFlags

Questo parametro è riservato e deve essere 0.

Valore restituito

Restituisce TRUE se l'URL è stato individuato o FALSE in caso contrario. Chiamare GetLastError per informazioni specifiche sull'errore. Gli errori possibili includono quanto segue.

Codice restituito Descrizione
ERROR_FILE_NOT_FOUND
 L'URL non è stato trovato nell'indice della cache, anche dopo aver preso in considerazione eventuali reindirizzamenti memorizzati nella cache.
ERROR_INSUFFICIENT_BUFFER
 Il buffer a cui fa riferimento lpCacheEntryInfo non è abbastanza grande per contenere le informazioni richieste. Le dimensioni del buffer necessarie verranno restituite a lpdwCacheEntryInfoBufSize.

Commenti

GetUrlCacheEntryInfoEx non esegue l'analisi degli URL, quindi un URL contenente un ancoraggio (#) non verrà trovato nella cache, anche se la risorsa viene memorizzata nella cache. Ad esempio, se l'URL http://example.com/example.htm#sample viene passato, la funzione restituisce ERROR_FILE_NOT_FOUND anche se http://example.com/example.htm si trova nella cache.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).
 

Nota

L'intestazione wininet.h definisce GetUrlCacheEntryInfoEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wininet.h
Libreria Wininet.lib
DLL Wininet.dll

Vedi anche

Memorizzazione nella cache

Funzioni WinINet