struttura INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Articolo
11/20/2024

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;

Membri

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 che contiene 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: voci di cronologia (URLHISTORY_CACHE_ENTRY), voci di cookie (COOKIE_CACHE_ENTRY) e contenuto normale memorizzato nella cache (NORMAL_CACHE_ENTRY).

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

Valore	Significato
EDITED_CACHE_ENTRY	File di immissione della cache modificato esternamente. Questo tipo di voce della cache è esente da scavenging.
SPARSE_CACHE_ENTRY	Voce della cache di risposta parziale.
STICKY_CACHE_ENTRY	Voce della cache permanente esente da scavenging per il periodo di tempo specificato da dwExemptDelta. Il valore predefinito impostato da CommitUrlCacheEntryA e CommitUrlCacheEntryW è un giorno.
TRACK_OFFLINE_CACHE_ENTRY	Attualmente non implementato.
TRACK_ONLINE_CACHE_ENTRY	Attualmente non implementato.

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

Valore	Significato
COOKIE_CACHE_ENTRY	Voce della cache dei cookie.
NORMAL_CACHE_ENTRY	Voce di cache normale; può essere eliminato per recuperare spazio per le nuove voci.
URLHISTORY_CACHE_ENTRY	Voce della cache dei collegamenti visitata.

dwUseCount

Numero corrente di chiamanti WinINEet che usano la voce della cache.

dwHitRate

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

dwSizeLow

Parte bassa delle dimensioni del file, in byte .

dwSizeHigh

Parte elevata delle dimensioni del file, in byte .

LastModifiedTime

struttura FILETIME che contiene l'ora dell'ultima modifica dell'URL, in formato ora medio di Greenwich.

ExpireTime

struttura di FILETIME che contiene l'ora di scadenza del file, in formato ora medio di Greenwich.

LastAccessTime

struttura FILETIME che contiene l'ora dell'ultimo accesso, in formato ora medio di Greenwich.

LastSyncTime

struttura FILETIME contenente l'ultima sincronizzazione della cache.

lpHeaderInfo

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

dwHeaderInfoSize

Dimensioni del buffer di 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

Tempo di esenzione dall'ultimo tempo di accesso, espresso in secondi.

Osservazioni

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

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 INTERNET_CACHE_ENTRY_INFO 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]
intestazione	wininet.h