Метод IOleCache2::UpdateCache (oleidl.h)

Статья
08/25/2023

Обновления указанные кэши. Этот метод используется, когда приложению требуется точный контроль над кэшированием.

Синтаксис

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

Параметры

[in] pDataObject

Указатель на интерфейс IDataObject для объекта данных, из которого обновляется кэш. Обработчики объектов и внутрипроцессные серверы обычно передают значение, отличное от NULL . Контейнерное приложение обычно передает значение NULL, а источник получается из выполняющихся в данный момент объектов.

[in] grfUpdf

Тип обновляемого кэша. Этот параметр может быть одним или несколькими из следующих значений.

Значение	Значение
UPDFCACHE_NODATACACHE	Обновления кэши, созданные с помощью ADVF_NODATA в вызове IOleCache::Cache.
UPDFCACHE_ONSAVECACHE	Обновления кэши, созданные с помощью ADVFCACHE_ONSAVE в вызове IOleCache::Cache.
UPDFCACHE_ONSTOPCACHE	Обновления кэши, созданные с помощью ADVFCACHE_ONSTOP в вызове IOleCache::Cache.
UPDFCACHE_NORMALCACHE	Динамически обновляет кэши (как это обычно делается, когда объект отправляет уведомления OnDataChange ).
UPDFCACHE_IFBLANK	Обновления кэш, если он пуст, независимо от любого другого указанного флага.
UPDFCACHE_ONLYIFBLANK	Обновления только пустые кэши.
UPDFCACHE_ IFBLANKORONSAVECACHE	Эквивалент использования операции OR для объединения UPDFCACHE_IFBLANK и UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL	Обновления все кэши.
UPDFCACHE_ ALLBUTNODATACACHE	Обновления все кэши, кроме созданных с помощью ADVF_NODATA в вызове IOleCache::Cache. Таким образом, вы можете управлять обновлениями кэшей, созданных с помощью флага ADVF_NODATA, и обновлять эти кэши только явным образом.

[in] pReserved

Этот параметр зарезервирован и должен иметь значение NULL.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
E_INVALIDARG	Один из аргументов недопустим.
E_UNEXPECTED	Произошла непредвиденная ошибка.
E_OUTOFMEMORY	Для этой операции недостаточно памяти.
OLE_E_NOTRUNNING	Указанный объект pDataObject не выполняется.
CACHE_E_NOCACHE_UPDATED	Ни один из кэшей не был обновлен.
CACHE_S_SOMECACHES_NOTUPDATED	Некоторые кэши были обновлены.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	oleidl.h

См. также раздел

Поделиться через