IOleCache2::UpdateCache-Methode (oleidl.h)

  • Artikel

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

Idataobject

IOleCache

IOleCache2

IOleCacheControl