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 |
|---|---|
|
Não há armazenamento disponível para salvar os dados no cache. |
|
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 |