Funzione FindFirstUrlCacheEntryW (wininet.h)

  • Articolo

Avvia l'enumerazione della cache Internet.

Sintassi

HANDLE FindFirstUrlCacheEntryW(
  [in]      LPCWSTR                      lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parametri

[in] lpszUrlSearchPattern

Puntatore a una stringa contenente il modello di nome origine da cercare. Questo parametro può essere impostato solo su "cookie:", "visited:" o NULL. Impostare questo parametro su "cookie:" per enumerare i cookie o "visited:" per enumerare le voci cronologia URL nella cache. Se questo parametro è NULL, FindFirstUrlCacheEntry restituisce tutte le voci di contenuto nella cache.

[out] lpFirstCacheEntryInfo

Puntatore a una struttura INTERNET_CACHE_ENTRY_INFO .

[in, out] lpcbCacheEntryInfo

Puntatore a una variabile che specifica le dimensioni del buffer lpFirstCacheEntryInfo , in byte. Quando la funzione restituisce, la variabile contiene il numero di byte copiati nel buffer o le dimensioni necessarie per recuperare la voce della cache in byte.

Valore restituito

Restituisce un handle che l'applicazione può usare nella funzione FindNextUrlCacheEntry per recuperare le voci successive nella cache. Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

ERROR_INSUFFICIENT_BUFFER indica che le dimensioni di lpFirstCacheEntryInfo come specificato da lpdwFirstCacheEntryInfoBufferSize non sono sufficienti per contenere tutte le informazioni. Il valore restituito in lpdwFirstCacheEntryInfoBufferSize indica la dimensione del buffer necessaria per contenere tutte le informazioni.

Commenti

L'handle restituito da FindFirstUrlCacheEntry viene usato in tutte le chiamate successive a FindNextUrlCacheEntry. Alla fine dell'enumerazione, l'applicazione deve chiamare FindCloseUrlCache.

FindFirstUrlCacheEntry e FindNextUrlCacheEntry restituiscono informazioni sulle dimensioni delle variabili. Se viene restituito ERROR_INSUFFICIENT_BUFFER, l'applicazione deve allocare un buffer delle dimensioni specificate da lpdwFirstCacheEntryInfoBufferSize. Per altre informazioni, vedere Uso dei buffer.

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

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

Nota

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

Requisiti

   
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