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

Artigo
03/13/2024

Atualizações os caches especificados. Esse método é usado quando o aplicativo precisa de controle preciso sobre o cache.

Sintaxe

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

Parâmetros

[in] pDataObject

Um ponteiro para a interface IDataObject no objeto de dados do qual o cache é atualizado. Manipuladores de objetos e servidores em processo normalmente passam um valor não NULL . Um aplicativo de contêiner geralmente passa NULL e a origem é obtida do objeto em execução no momento.

[in] grfUpdf

O tipo de cache a ser atualizado. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
UPDFCACHE_NODATACACHE	Atualizações caches criados usando ADVF_NODATA na chamada para IOleCache::Cache.
UPDFCACHE_ONSAVECACHE	Atualizações caches criados usando ADVFCACHE_ONSAVE na chamada para IOleCache::Cache.
UPDFCACHE_ONSTOPCACHE	Atualizações caches criados usando ADVFCACHE_ONSTOP na chamada para IOleCache::Cache.
UPDFCACHE_NORMALCACHE	Atualiza dinamicamente os caches (como normalmente é feito quando o objeto envia avisos onDataChange ).
UPDFCACHE_IFBLANK	Atualizações o cache se estiver em branco, independentemente de qualquer outro sinalizador especificado.
UPDFCACHE_ONLYIFBLANK	Atualizações apenas os caches que estão em branco.
UPDFCACHE_ IFBLANKORONSAVECACHE	O equivalente a usar uma operação OR para combinar UPDFCACHE_IFBLANK e UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL	Atualizações todos os caches.
UPDFCACHE_ ALLBUTNODATACACHE	Atualizações todos os caches, exceto aqueles criados com ADVF_NODATA na chamada para IOleCache::Cache. Assim, você pode controlar as atualizações para os caches criados com o sinalizador ADVF_NODATA e atualizar apenas esses caches explicitamente.

[in] pReserved

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_INVALIDARG	Um dos argumentos não é válido.
E_UNEXPECTED	Ocorreu um erro inesperado.
E_OUTOFMEMORY	A memória insuficiente está disponível para esta operação.
OLE_E_NOTRUNNING	O pDataObject especificado não está em execução.
CACHE_E_NOCACHE_UPDATED	Nenhum dos caches foi atualizado.
CACHE_S_SOMECACHES_NOTUPDATED	Alguns dos caches foram atualizados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h

Confira também

Compartilhar via