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

Artículo
08/25/2023

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

Compartir a través de