通过

ILockBytes::Flush

  • 项目

This method ensures that any internal buffers maintained by the byte array object are written out to the backing storage.

HRESULT Flush(void);

Parameters

None.

Return Values

The following table shows the return values for this method.

Value 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, Flush does a dump-and-close to 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.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib, Uuid.lib.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.