Método IOleCache2::D iscardCache (oleidl.h)

Descarta os caches encontrados na memória.

Sintaxe

HRESULT DiscardCache(
  [in] DWORD dwDiscardOptions
);

Parâmetros

[in] dwDiscardOptions

Um valor da enumeração DISCARDCACHE que indica se os dados devem ser salvos antes de serem descartados. Contêineres que desenharam um objeto grande e precisam liberar memória podem especificar DISCARDCACHE_SAVEIFDIRTY para que a apresentação mais recente seja salva para a próxima vez que o objeto precisar ser desenhado.

Contêineres que ativaram um objeto inserido, fizeram algumas alterações e, em seguida, chamaram IOleObject::Close com OLECLOSE_NOSAVE para reverter as alterações podem especificar DISCARDCACHE_NOSAVE para garantir que os dados nativos e de apresentação não estejam fora da sincronização.

Retornar valor

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

Código de retorno	Descrição
OLE_E_NOSTORAGE	Não há armazenamento disponível para salvar os dados no cache.
STG_E_MEDIUMFULL	A mídia de armazenamento está cheia.

Comentários

O método IOleCache2::D iscardCache é comumente usado para lidar com condições de memória insuficiente liberando memória atualmente sendo usada por caches de apresentação.

Depois de descartado, um cache atenderá às chamadas IDataObject::GetData subsequentes revertendo para dados baseados em disco.

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

IOleCache

IOleCache2

IOleCacheControl