Metodo IOleCache2::UpdateCache (oleidl.h)

Articolo
08/25/2023

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

Condividi tramite