Partager via


SetUrlCacheEntryInfoA, fonction (wininet.h)

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 contenir aucun caractère 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 la dernière heure d’accès.
CACHE_ENTRY_ATTRIBUTE_FC
Définit le type d’entrée du 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
Non implémenté actuellement.
CACHE_ENTRY_HITRATE_FC
Définit le taux d’accès.
CACHE_ENTRY_MODTIME_FC
Définit l’heure de dernière modification.
CACHE_ENTRY_SYNCTIME_FC
Définit l’heure de la dernière synchronisation.

Valeur de retour

Retourne TRUE en cas de réussite ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Les valeurs d’erreur possibles sont les suivantes.

Retourner le code 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

Remarque 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).
 

Note

L’en-tête wininet.h définit SetUrlCacheEntryInfo comme 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête wininet.h
bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

mise en cache

fonctions WinINet