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 della 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 voce 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 dei cookie.
EDITED_CACHE_ENTRY
 File di immissione della cache modificato esternamente. Questo tipo di voce della cache è esente da scavenging.
NORMAL_CACHE_ENTRY
 Voce di cache normale; può essere eliminato per recuperare spazio per le nuove voci.
SPARSE_CACHE_ENTRY
 Voce della cache di risposta parziale.
STICKY_CACHE_ENTRY
 Voce della cache permanente; esente da scavenging.
TRACK_OFFLINE_CACHE_ENTRY
 Attualmente non implementato.
TRACK_ONLINE_CACHE_ENTRY
 Attualmente non implementato.
URLHISTORY_CACHE_ENTRY
 Voce della cache dei collegamenti visitata.

[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 di immissione 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.

Osservazioni

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 dall'interno di 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 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione wininet.h
libreria Wininet.lib
dll Wininet.dll

Vedere anche

memorizzazione nella cache

funzioni WinINet