IOleCache2::UpdateCache-Methode (oleidl.h)

Artikel
08/25/2023

Updates die angegebenen Caches. Diese Methode wird verwendet, wenn die Anwendung eine präzise Kontrolle über die Zwischenspeicherung benötigt.

Syntax

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

Parameter

[in] pDataObject

Ein Zeiger auf die IDataObject-Schnittstelle für das Datenobjekt, aus dem der Cache aktualisiert wird. Objekthandler und Prozessserver übergeben in der Regel einen Wert ungleich NULL . Eine Containeranwendung übergibt in der Regel NULL, und die Quelle wird aus dem derzeit ausgeführten -Objekt abgerufen.

[in] grfUpdf

Der Typ des zu aktualisierenden Caches. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
UPDFCACHE_NODATACACHE	Updates Caches, die mithilfe von ADVF_NODATA im Aufruf von IOleCache::Cache erstellt wurden.
UPDFCACHE_ONSAVECACHE	Updates Caches, die mithilfe von ADVFCACHE_ONSAVE im Aufruf von IOleCache::Cache erstellt wurden.
UPDFCACHE_ONSTOPCACHE	Updates Caches, die mithilfe von ADVFCACHE_ONSTOP im Aufruf von IOleCache::Cache erstellt wurden.
UPDFCACHE_NORMALCACHE	Aktualisiert die Caches dynamisch (wie normalerweise, wenn das Objekt OnDataChange-Benachrichtigungen sendet).
UPDFCACHE_IFBLANK	Updates den Cache leer, unabhängig von anderen angegebenen Flags.
UPDFCACHE_ONLYIFBLANK	Updates nur Caches, die leer sind.
UPDFCACHE_ IFBLANKORONSAVECACHE	Das Äquivalent zur Verwendung eines OR-Vorgangs zum Kombinieren von UPDFCACHE_IFBLANK und UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL	Updates alle Caches.
UPDFCACHE_ ALLBUTNODATACACHE	Updates alle Caches außer denen, die mit ADVF_NODATA im Aufruf von IOleCache::Cache erstellt wurden. Daher können Sie Updates für die Mit dem flag ADVF_NODATA erstellten Caches steuern und diese Caches nur explizit aktualisieren.

[in] pReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Eines der Argumente ist ungültig.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
OLE_E_NOTRUNNING	Das angegebene pDataObject wird nicht ausgeführt.
CACHE_E_NOCACHE_UPDATED	Keiner der Caches wurde aktualisiert.
CACHE_S_SOMECACHES_NOTUPDATED	Einige der Caches wurden aktualisiert.

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

Freigeben über