Fonction SetUrlCacheEntryInfoA (wininet.h)

Article
03/04/2024

Définit les membres spécifiés de la structure INTERNET_CACHE_ENTRY_INFO .

Syntaxe

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

Paramètres

[in] lpszUrlName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’entrée de cache. La chaîne de nom ne doit pas contenir de caractères d’échappement.

[in] lpCacheEntryInfo

Pointeur vers une structure INTERNET_CACHE_ENTRY_INFO contenant les valeurs à affecter à l’entrée de cache désignée par lpszUrlName.

[in] dwFieldControl

Indique les membres à définir. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
CACHE_ENTRY_ACCTIME_FC	Définit l’heure du dernier accès.
CACHE_ENTRY_ATTRIBUTE_FC	Définit le type d’entrée de cache.
CACHE_ENTRY_EXEMPT_DELTA_FC	Définit le delta exempté.
CACHE_ENTRY_EXPTIME_FC	Définit l’heure d’expiration.
CACHE_ENTRY_HEADERINFO_FC	Actuellement non implémenté.
CACHE_ENTRY_HITRATE_FC	Définit le taux d’accès.
CACHE_ENTRY_MODTIME_FC	Définit l’heure de la dernière modification.
CACHE_ENTRY_SYNCTIME_FC	Définit l’heure de la dernière synchronisation.

Valeur retournée

Retourne LA valeur TRUE si elle réussit ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
ERROR_FILE_NOT_FOUND	L’entrée de cache spécifiée est introuvable dans le cache.
ERROR_INVALID_PARAMETER	La ou les valeurs à définir ne sont pas valides.

Remarques

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Notes

L’en-tête wininet.h définit SetUrlCacheEntryInfo comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Mise en cache

Fonctions WinINet

Partager via