Funzione SetUrlCacheEntryInfoA (wininet.h)

Articolo
03/13/2024

Imposta i membri specificati della struttura INTERNET_CACHE_ENTRY_INFO .

Sintassi

BOOL SetUrlCacheEntryInfoA(
  [in] LPCSTR                       lpszUrlName,
  [in] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in] DWORD                        dwFieldControl
);

Parametri

[in] lpszUrlName

Puntatore a una stringa con terminazione null che specifica il nome della voce della cache. La stringa del nome non deve contenere caratteri di escape.

[in] lpCacheEntryInfo

Puntatore a una struttura INTERNET_CACHE_ENTRY_INFO contenente i valori da assegnare alla voce della cache designata da lpszUrlName.

[in] dwFieldControl

Indica i membri che devono essere impostati. Questo parametro può essere una combinazione dei valori seguenti.

Valore	Significato
CACHE_ENTRY_ACCTIME_FC	Imposta l'ultima ora di accesso.
CACHE_ENTRY_ATTRIBUTE_FC	Imposta il tipo di voce della cache.
CACHE_ENTRY_EXEMPT_DELTA_FC	Imposta il delta esentato.
CACHE_ENTRY_EXPTIME_FC	Imposta l'ora di scadenza.
CACHE_ENTRY_HEADERINFO_FC	Non implementato attualmente.
CACHE_ENTRY_HITRATE_FC	Imposta la frequenza di hit.
CACHE_ENTRY_MODTIME_FC	Imposta l'ultima ora modificata.
CACHE_ENTRY_SYNCTIME_FC	Imposta l'ultima ora di sincronizzazione.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_FILE_NOT_FOUND	La voce della cache specificata non viene trovata nella cache.
ERROR_INVALID_PARAMETER	I valori da impostare non sono validi.

Commenti

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 SetUrlCacheEntryInfo 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]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Memorizzazione nella cache

Funzioni WinINet

Condividi tramite