Condividi tramite

Funzione FindFirstUrlCacheEntryExA (wininet.h)

  • Articolo

Avvia un'enumerazione filtrata della cache Internet.

Sintassi

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

Parametri

[in] lpszUrlSearchPattern

Puntatore a una stringa contenente il modello di nome di 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, FindFirstUrlCacheEntryEx restituisce tutte le voci di contenuto nella cache.

[in] dwFlags

Controlla l'enumerazione . Non sono attualmente implementati flag; questo parametro deve essere impostato su zero.

[in] dwFilter

Maschera di bit che indica il tipo di voce della cache e le relative proprietà. I tipi di voci della cache includono: voci di cronologia (URLHISTORY_CACHE_ENTRY), voci di cookie (COOKIE_CACHE_ENTRY) e contenuto normale memorizzato nella cache (NORMAL_CACHE_ENTRY).

Questo parametro può essere zero o più dei flag di proprietà seguenti e i flag del tipo di cache elencati di seguito.

Valore Significato
COOKIE_CACHE_ENTRY
 Voce della cache del cookie.
EDITED_CACHE_ENTRY
 File di voce della cache che è stato modificato esternamente. Questo tipo di voce della cache è esente da scavenging.
NORMAL_CACHE_ENTRY
 Normale voce della cache. Può essere eliminata per recuperare spazio per nuove voci.
SPARSE_CACHE_ENTRY
 Voce della cache di risposta parziale.
STICKY_CACHE_ENTRY
 Voce della cache permanente. Esentata dallo scavenging.
TRACK_OFFLINE_CACHE_ENTRY
 Non implementato attualmente.
TRACK_ONLINE_CACHE_ENTRY
 Non implementato attualmente.
URLHISTORY_CACHE_ENTRY
 Voce della cache di collegamento visitato.

[in] GroupId

ID del gruppo di cache da enumerare. Impostare questo parametro su zero per enumerare tutte le voci non raggruppate.

[out] lpFirstCacheEntryInfo

Puntatore a una struttura INTERNET_CACHE_ENTRY_INFO per ricevere le informazioni sulla voce della cache.

[in, out] lpcbCacheEntryInfo

Puntatore a variabile che indica le dimensioni della struttura a cui fa riferimento il parametro lpFirstCacheEntryInfo , in byte.

[out] lpGroupAttributes

Questo parametro è riservato e deve essere NULL.

[in, out] lpcbGroupAttributes

Questo parametro è riservato e deve essere NULL.

[in] lpReserved

Questo parametro è riservato e deve essere NULL.

Valore restituito

Restituisce un handle valido se ha esito positivo o NULL in caso contrario. Per ottenere informazioni specifiche sull'errore, chiamare GetLastError. Se la funzione non trova file corrispondenti, GetLastError restituisce ERROR_NO_MORE_FILES.

Commenti

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

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

   
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