Compartilhar via

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

  • Artigo

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

Idataobject

IOleCache

IOleCache2

IOleCacheControl