Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Flush method ensures that any internal buffers maintained by the ILockBytes implementation are written out to the underlying physical storage.
Syntax
HRESULT Flush();
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
| 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, the Flush method executes a download-and-closeto flush, which can lead to a return value of STG_E_TOOMANYFILESOPEN if no file handles are available. |
| STG_E_INVALIDHANDLE | An underlying file has been prematurely closed, or the correct floppy disk has been replaced by an invalid one. |
Remarks
ILockBytes::Flush flushes internal buffers to the underlying storage device.
The COM-provided implementation of compound files calls this method during a transacted commit operation to provide a two-phase commit process that protects against loss of data.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps | UWP apps] |
| Minimum supported server | Windows 2000 Server [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | objidl.h |
| Library | Uuid.lib |
| DLL | Ole32.dll |
See also
ILockBytes - File-Based Implementation