Share via

Método IOleCache2::UpdateCache (oleidl.h)

  • Artículo

Novedades las memorias caché especificadas. Este método se usa cuando la aplicación necesita un control preciso sobre el almacenamiento en caché.

Sintaxis

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

Parámetros

[in] pDataObject

Puntero a la interfaz IDataObject en el objeto de datos desde el que se actualiza la memoria caché. Los controladores de objetos y los servidores en proceso normalmente pasan un valor distinto de NULL . Normalmente, una aplicación contenedora pasa NULL y el origen se obtiene del objeto que se está ejecutando actualmente.

[in] grfUpdf

Tipo de caché que se va a actualizar. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
UPDFCACHE_NODATACACHE
Novedades cachés creadas mediante ADVF_NODATA en la llamada a IOleCache::Cache.
UPDFCACHE_ONSAVECACHE
Novedades cachés creadas mediante ADVFCACHE_ONSAVE en la llamada a IOleCache::Cache.
UPDFCACHE_ONSTOPCACHE
Novedades memorias caché creadas mediante ADVFCACHE_ONSTOP en la llamada a IOleCache::Cache.
UPDFCACHE_NORMALCACHE
 Actualiza dinámicamente las memorias caché (como se hace normalmente cuando el objeto envía avisos de OnDataChange ).
UPDFCACHE_IFBLANK
 Novedades la memoria caché si está en blanco, independientemente de cualquier otra marca especificada.
UPDFCACHE_ONLYIFBLANK
 Novedades solo las memorias caché que están en blanco.
UPDFCACHE_ IFBLANKORONSAVECACHE
 Equivalente al uso de una operación OR para combinar UPDFCACHE_IFBLANK y UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL
 Novedades todas las memorias caché.
UPDFCACHE_ ALLBUTNODATACACHE
 Novedades todas las memorias caché excepto las creadas con ADVF_NODATA en la llamada a IOleCache::Cache. Por lo tanto, puede controlar las actualizaciones de las memorias caché creadas con la marca ADVF_NODATA y actualizar solo estas cachés explícitamente.

[in] pReserved

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
E_INVALIDARG
 Uno de los argumentos no es válido.
E_UNEXPECTED
 Se produjo un error inesperado.
E_OUTOFMEMORY
 No hay suficiente memoria disponible para esta operación.
OLE_E_NOTRUNNING
 El objeto pDataObject especificado no se está ejecutando.
CACHE_E_NOCACHE_UPDATED
 No se actualizó ninguna de las memorias caché.
CACHE_S_SOMECACHES_NOTUPDATED
 Se actualizaron algunas de las memorias caché.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

IDataObject

IOleCache

IOleCache2

IOleCacheControl