ILockBytes::Flush

Ensures that any internal buffers maintained by the ILockBytes implementation are written out to the backing storage.

HRESULT Flush(void);
Return Values
S_OK

The flush operation was successful.

STG_E_ACCESSDENIED

The caller does not have permission to access the byte array.

STG_E_MEDIUMFULL

The flush operation is not completed because there is no space left on the storage device.

E_FAIL

General failure writing data.

STG_E_TOOMANYFILESOPEN

Under certain circumstances, Flush does a dump-and-close to flush. This can lead to STG_E_TOOMANYFILESOPEN if there are no file handles available.

STG_E_INVALIDHANDLE

An invalid floppy change has been made.

Comments
This method flushes internal buffers to the underlying storage device.

The OLE-provided implementation of compound files uses this method during a transacted commit operation to provide a two-phase commit process that protects against loss of data.