Funzione FindFirstUrlCacheEntryExA (wininet.h)
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 |
---|---|
|
Voce della cache del cookie. |
|
File di voce della cache che è stato modificato esternamente. Questo tipo di voce della cache è esente da scavenging. |
|
Normale voce della cache. Può essere eliminata per recuperare spazio per nuove voci. |
|
Voce della cache di risposta parziale. |
|
Voce della cache permanente. Esentata dallo scavenging. |
|
Non implementato attualmente. |
|
Non implementato attualmente. |
|
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
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 |