Funzione CommitUrlCacheEntryA (wininet.h)

Archivia i dati nel file specificato nella cache Internet e lo associa all'URL specificato.

Sintassi

BOOL CommitUrlCacheEntryA(
  [in] LPCSTR   lpszUrlName,
  [in] LPCSTR   lpszLocalFileName,
  [in] FILETIME ExpireTime,
  [in] FILETIME LastModifiedTime,
  [in] DWORD    CacheEntryType,
  [in] LPBYTE   lpHeaderInfo,
  [in] DWORD    cchHeaderInfo,
  [in] LPCSTR   lpszFileExtension,
  [in] LPCSTR   lpszOriginalUrl
);

Parametri

[in] lpszUrlName

Puntatore a una variabile stringa contenente il nome di origine della voce della cache. La stringa del nome deve essere univoca e non deve contenere caratteri di escape.

[in] lpszLocalFileName

Puntatore a una variabile stringa contenente il nome del file locale memorizzato nella cache. Deve essere lo stesso nome restituito da CreateUrlCacheEntryA.

[in] ExpireTime

Struttura FILETIME contenente la data e l'ora di scadenza (in tempo medio di Greenwich) del file memorizzato nella cache. Se la data e l'ora di scadenza sono sconosciute, impostare questo parametro su zero.

[in] LastModifiedTime

Struttura FILETIME contenente l'ultima data e ora modificata (in tempo medio di Greenwich) dell'URL memorizzato nella cache. Se l'ultima data e ora modificata è sconosciuta, impostare questo parametro su zero.

[in] 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 parametro può essere zero o più dei flag di proprietà seguenti e i flag di tipo cache elencati di seguito.

[in] lpHeaderInfo

Puntatore al buffer contenente le informazioni sull'intestazione. Se questo parametro non è NULL, le informazioni sull'intestazione vengono considerate come attributi estesi dell'URL restituito nel membro lpHeaderInfo della struttura INTERNET_CACHE_ENTRY_INFO .

[in] cchHeaderInfo

Dimensioni delle informazioni sull'intestazione, in TCHARs. Se lpHeaderInfo non è NULL, questo valore viene assunto per indicare le dimensioni del buffer che archivia le informazioni sull'intestazione. Un'applicazione può gestire le intestazioni come parte dei dati e fornire cchHeaderInfo insieme a un valore NULL per lpHeaderInfo.

[in] lpszFileExtension

Questo parametro è riservato e deve essere NULL.

[in] lpszOriginalUrl

Puntatore a una stringa contenente l'URL originale, se si è verificato il reindirizzamento.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError. Di seguito sono riportati i valori di errore possibili.

Commenti

Il tipo di STICKY_CACHE_ENTRY viene usato per rendere le voci della cache esentate dalla scavenging. Il tempo di esenzione predefinito per le voci impostate usando CommitUrlCacheEntryA è di dieci minuti. L'ora di esenzione può essere modificata impostando il parametro ora di scadenza nella struttura INTERNET_CACHE_ENTRY_INFO nella chiamata alla funzione SetUrlCacheEntryInfo .

Se l'archiviazione della cache è completa, CommitUrlCacheEntryA richiama la pulizia della cache per rendere spazio per questo nuovo file. Se la voce della cache esiste già, la funzione sovrascrive la voce se non è in uso. Una voce viene usata quando è stata recuperata con RetrieveUrlCacheEntryStream o RetrieveUrlCacheEntryFile.

I client che aggiungono voci alla cache devono impostare le intestazioni su almeno "HTTP/1.0 200 OK\r\n\r\n"; in caso contrario, Microsoft Internet Explorer e altre applicazioni client devono ignorare la voce.

Vedere Memorizzazione nella cache per esempio di codice che chiama CreateUrlCacheEntryA.

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 degli oggetti globali.

Requisiti

Vedi anche

Memorizzazione nella cache

Funzioni WinINet