INTERNET_CACHE_ENTRY_INFOA struttura (wininet.h)

Articolo
08/27/2023

Contiene informazioni su una voce nella cache Internet.

Sintassi

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

Members

dwStructSize

Dimensioni di questa struttura, in byte. Questo valore può essere usato per determinare la versione del sistema della cache.

lpszSourceUrlName

Puntatore a una stringa con terminazione null contenente il nome DELL'URL. La stringa occupa l'area di memoria alla fine di questa struttura.

lpszLocalFileName

Puntatore a una stringa con terminazione null contenente il nome del file locale. La stringa occupa l'area di memoria alla fine di questa struttura.

CacheEntryType

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

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

Valore	Significato
EDITED_CACHE_ENTRY	File di voce della cache modificato esternamente. Questo tipo di voce della cache è esentato dalla scavenging.
SPARSE_CACHE_ENTRY	Voce della cache di risposta parziale.
STICKY_CACHE_ENTRY	Voce della cache sticky esentata dalla scavenging per la quantità di tempo specificata da dwExemptDelta. Il valore predefinito impostato da CommitUrlCacheEntryA e CommitUrlCacheEntryW è un giorno.
TRACK_OFFLINE_CACHE_ENTRY	Non implementato attualmente.
TRACK_ONLINE_CACHE_ENTRY	Non implementato attualmente.

L'elenco seguente contiene i flag del tipo di cache.

Valore	Significato
COOKIE_CACHE_ENTRY	Voce della cache del cookie.
NORMAL_CACHE_ENTRY	Normale voce della cache. Può essere eliminata per recuperare spazio per nuove voci.
URLHISTORY_CACHE_ENTRY	Voce della cache di collegamento visitato.

dwUseCount

Numero corrente di chiamanti WinINEet usando la voce della cache.

dwHitRate

Numero di volte in cui è stata recuperata la voce della cache.

dwSizeLow

Parte a basso ordine delle dimensioni del file, in byte.

dwSizeHigh

Parte elevata dell'ordine elevato delle dimensioni del file, in byte.

LastModifiedTime

Struttura FILETIME che contiene l'ultima ora modificata di questo URL, nel formato di tempo medio di Greenwich.

ExpireTime

Struttura FILETIME che contiene l'ora di scadenza di questo file, nel formato di tempo medio di Greenwich.

LastAccessTime

Struttura FILETIME che contiene l'ultima ora di accesso, nel formato di tempo medio di Greenwich.

LastSyncTime

Struttura FILETIME contenente l'ultima volta che la cache è stata sincronizzata.

lpHeaderInfo

Puntatore a un buffer contenente le informazioni sull'intestazione. Il buffer occupa la memoria alla fine di questa struttura.

dwHeaderInfoSize

Dimensioni del buffer lpHeaderInfo , in TCHARs.

lpszFileExtension

Puntatore a una stringa contenente l'estensione del nome file usata per recuperare i dati come file. La stringa occupa l'area di memoria alla fine di questa struttura.

dwReserved

dwExemptDelta

Ora di esenzione dall'ultima ora di accesso, in secondi.

Commenti

Non esiste alcun limite di dimensioni della cache, pertanto le applicazioni che devono enumerare la cache devono essere preparate per allocare buffer di dimensioni variabili. Per altre informazioni, vedere Uso dei buffer.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	wininet.h