IOleCache2::D iscardCache-Methode (oleidl.h)

Verwirft die im Arbeitsspeicher gefundenen Caches.

Syntax

HRESULT DiscardCache(
  [in] DWORD dwDiscardOptions
);

Parameter

[in] dwDiscardOptions

Ein Wert aus der DISCARDCACHE-Enumeration , der angibt, ob Daten vor dem Verwerfen gespeichert werden sollen. Container, die ein großes Objekt gezeichnet haben und Arbeitsspeicher freigeben müssen, können DISCARDCACHE_SAVEIFDIRTY angeben, damit die neueste Präsentation beim nächsten Zeichnen des Objekts gespeichert wird.

Container, die ein eingebettetes Objekt aktiviert, einige Änderungen vorgenommen und dann IOleObject::Close mit OLECLOSE_NOSAVE aufgerufen haben, um die Änderungen rückgängig zu machen, können DISCARDCACHE_NOSAVE angeben, um sicherzustellen, dass die nativen Daten und die Präsentationsdaten nicht nicht synchron sind.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
OLE_E_NOSTORAGE
Es ist kein Speicher zum Speichern der Daten im Cache verfügbar.
STG_E_MEDIUMFULL
Das Speichermedium ist voll.

Hinweise

Die IOleCache2::D iscardCache-Methode wird häufig verwendet, um geringe Arbeitsspeicherbedingungen zu verarbeiten, indem Speicher freigegeben wird, der derzeit von Präsentationscaches verwendet wird.

Nachdem er verworfen wurde, erfüllt ein Cache nachfolgende IDataObject::GetData-Aufrufe , indem er auf datenträgerbasierte Daten zurückgesetzt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

IOleCache

IOleCache2

IOleCacheControl