Méthode IOleCache2 ::UpdateCache (oleidl.h)

Article
03/01/2024

Mises à jour les caches spécifiés. Cette méthode est utilisée lorsque l’application a besoin d’un contrôle précis sur la mise en cache.

Syntaxe

HRESULT UpdateCache(
  [in] LPDATAOBJECT pDataObject,
  [in] DWORD        grfUpdf,
  [in] LPVOID       pReserved
);

Paramètres

[in] pDataObject

Pointeur vers l’interface IDataObject sur l’objet de données à partir duquel le cache est mis à jour. Les gestionnaires d’objets et les serveurs in-process passent généralement une valeur non NULL . Une application conteneur transmet généralement NULL, et la source est obtenue à partir de l’objet en cours d’exécution.

[in] grfUpdf

Type de cache à mettre à jour. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur	Signification
UPDFCACHE_NODATACACHE	Mises à jour caches créés à l’aide de ADVF_NODATA dans l’appel à IOleCache ::Cache.
UPDFCACHE_ONSAVECACHE	Mises à jour caches créés à l’aide de ADVFCACHE_ONSAVE dans l’appel à IOleCache ::Cache.
UPDFCACHE_ONSTOPCACHE	Mises à jour caches créés à l’aide de ADVFCACHE_ONSTOP dans l’appel à IOleCache ::Cache.
UPDFCACHE_NORMALCACHE	Met à jour dynamiquement les caches (comme c’est normalement fait lorsque l’objet envoie des avis OnDataChange ).
UPDFCACHE_IFBLANK	Mises à jour le cache s’il est vide, quel que soit l’autre indicateur spécifié.
UPDFCACHE_ONLYIFBLANK	Mises à jour uniquement les caches vides.
UPDFCACHE_ IFBLANKORONSAVECACHE	Équivaut à utiliser une opération OR pour combiner UPDFCACHE_IFBLANK et UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL	Mises à jour tous les caches.
UPDFCACHE_ ALLBUTNODATACACHE	Mises à jour tous les caches, à l’exception de ceux créés avec ADVF_NODATA dans l’appel à IOleCache ::Cache. Ainsi, vous pouvez contrôler les mises à jour des caches créés avec l’indicateur ADVF_NODATA et uniquement mettre à jour ces caches explicitement.

[in] pReserved

Ce paramètre est réservé et doit être NULL.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_INVALIDARG	L’un des arguments n’est pas valide.
E_UNEXPECTED	Une erreur inattendue s’est produite.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour cette opération.
OLE_E_NOTRUNNING	Le pDataObject spécifié n’est pas en cours d’exécution.
CACHE_E_NOCACHE_UPDATED	Aucun des caches n’a été mis à jour.
CACHE_S_SOMECACHES_NOTUPDATED	Certains caches ont été mis à jour.

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	oleidl.h

Voir aussi

Partager via