Funzione FindNextUrlCacheEntryA (wininet.h)

  • Articolo

Recupera la voce successiva nella cache Internet.

Sintassi

BOOL FindNextUrlCacheEntryA(
  [in]      HANDLE                       hEnumHandle,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parametri

[in] hEnumHandle

Gestire l'enumerazione ottenuta da una chiamata precedente a FindFirstUrlCacheEntry.

[out] lpNextCacheEntryInfo

Puntatore a una struttura INTERNET_CACHE_ENTRY_INFO che riceve informazioni sulla voce della cache.

[in, out] lpcbCacheEntryInfo

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

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
ERROR_INSUFFICIENT_BUFFER
 Le dimensioni di lpNextCacheEntryInfo come specificato da lpdwNextCacheEntryInfoBufferSize non sono sufficienti per contenere tutte le informazioni. Il valore restituito in lpdwNextCacheEntryInfoBufferSize indica la dimensione del buffer necessaria per contenere tutte le informazioni.
ERROR_NO_MORE_ITEMS
 Enumerazione completata.

Commenti

Continuare a chiamare FindNextUrlCacheEntry finché non viene restituito l'ultimo elemento nella cache.

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