Fonction SetUrlCacheEntryInfoA (wininet.h)

  • Article

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