Método ILockBytes::Flush (objidl.h)
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