Méthode IOleCache2 ::D iscardCache (oleidl.h)
Ignore les caches trouvés dans la mémoire.
Syntaxe
HRESULT DiscardCache(
[in] DWORD dwDiscardOptions
);
Paramètres
[in] dwDiscardOptions
Valeur de l’énumération DISCARDCACHE qui indique si les données doivent être enregistrées avant d’être ignorées. Les conteneurs qui ont dessiné un objet volumineux et qui doivent libérer de la mémoire peuvent spécifier DISCARDCACHE_SAVEIFDIRTY afin que la présentation la plus récente soit enregistrée pour la prochaine fois que l’objet doit être dessiné.
Les conteneurs qui ont activé un objet incorporé, apporté des modifications, puis appelé IOleObject ::Close avec OLECLOSE_NOSAVE pour restaurer les modifications peuvent spécifier DISCARDCACHE_NOSAVE pour s’assurer que les données natives et de présentation ne sont pas non synchronisées.
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 |
|---|---|
|
Aucun stockage n’est disponible pour enregistrer les données dans le cache. |
|
Le support de stockage est plein. |
Remarques
La méthode IOleCache2 ::D iscardCache est couramment utilisée pour gérer les conditions de mémoire insuffisante en libérant la mémoire actuellement utilisée par les caches de présentation.
Une fois qu’il est ignoré, un cache répond aux appels IDataObject ::GetData suivants en rétablissant les données sur disque.
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 |