Método ILockBytes::Flush (objidl.h)

  • Artigo

O método Flush garante que todos os buffers internos mantidos pela implementação ILockBytes sejam gravados no armazenamento físico subjacente.

Sintaxe

HRESULT Flush();

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK A operação de liberação foi bem-sucedida.
STG_E_ACCESSDENIED O chamador não tem permissão para acessar a matriz de bytes.
STG_E_MEDIUMFULL A operação de liberação não foi concluída porque não há espaço no dispositivo de armazenamento.
E_FAIL Falha geral ao gravar dados.
STG_E_TOOMANYFILESOPEN Em determinadas circunstâncias, o método Flush executa um download-and-closeto flush, o que pode levar a um valor retornado de STG_E_TOOMANYFILESOPEN se nenhum identificador de arquivo estiver disponível.
STG_E_INVALIDHANDLE Um arquivo subjacente foi fechado prematuramente ou o disquete correto foi substituído por um inválido.

Comentários

ILockBytes::Flush libera buffers internos para o dispositivo de armazenamento subjacente.

A implementação fornecida por COM de arquivos compostos chama esse método durante uma operação de confirmação transacionada para fornecer um processo de confirmação em duas fases que protege contra perda de dados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

ILockBytes – Implementação de File-Based

ILockBytes – Implementação de memória global

IStorage::Commit