Metodo IOleCache2::UpdateCache (oleidl.h)

Aggiornamenti le cache specificate. Questo metodo viene usato quando l'applicazione richiede un controllo preciso sulla memorizzazione nella cache.

Sintassi

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

Parametri

[in] pDataObject

Puntatore all'interfaccia IDataObject nell'oggetto dati da cui viene aggiornata la cache. I gestori oggetti e i server in-process passano in genere un valore non NULL . Un'applicazione contenitore passa in genere NULL e l'origine viene ottenuta dall'oggetto attualmente in esecuzione.

[in] grfUpdf

Tipo di cache da aggiornare. Questo parametro può essere uno o più dei valori seguenti.

Valore Significato
UPDFCACHE_NODATACACHE
Aggiornamenti cache create usando ADVF_NODATA nella chiamata a IOleCache::Cache.
UPDFCACHE_ONSAVECACHE
Aggiornamenti cache create usando ADVFCACHE_ONSAVE nella chiamata a IOleCache::Cache.
UPDFCACHE_ONSTOPCACHE
Aggiornamenti cache create usando ADVFCACHE_ONSTOP nella chiamata a IOleCache::Cache.
UPDFCACHE_NORMALCACHE
Aggiorna in modo dinamico le cache , come in genere viene eseguito quando l'oggetto invia avvisi OnDataChange .
UPDFCACHE_IFBLANK
Aggiornamenti la cache se vuota, indipendentemente da qualsiasi altro flag specificato.
UPDFCACHE_ONLYIFBLANK
Aggiornamenti solo cache vuote.
UPDFCACHE_ IFBLANKORONSAVECACHE
Equivalente all'uso di un'operazione OR per combinare UPDFCACHE_IFBLANK e UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL
Aggiornamenti tutte le cache.
UPDFCACHE_ ALLBUTNODATACACHE
Aggiornamenti tutte le cache, ad eccezione di quelle create con ADVF_NODATA nella chiamata a IOleCache::Cache. È quindi possibile controllare gli aggiornamenti delle cache create con il flag di ADVF_NODATA e aggiornare in modo esplicito queste cache.

[in] pReserved

Questo parametro è riservato e deve essere NULL.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito Descrizione
E_INVALIDARG
Uno degli argomenti non è valido.
E_UNEXPECTED
Si è verificato un errore imprevisto.
E_OUTOFMEMORY
Memoria insufficiente disponibile per questa operazione.
OLE_E_NOTRUNNING
Il pDataObject specificato non è in esecuzione.
CACHE_E_NOCACHE_UPDATED
Nessuna delle cache è stata aggiornata.
CACHE_S_SOMECACHES_NOTUPDATED
Alcune delle cache sono state aggiornate.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleidl.h

Vedi anche

Idataobject

IOleCache

IOleCache2

IOleCacheControl