Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ILockBytes - File-Based Implementation

Implemented on a byte array object underlying a COM compound file storage object, and designed to read and write directly to a disk file.

When to Use

Methods of ILockBytes are called from the compound file implementations of IStorage and IStream on the compound file storage object created through a call to StgCreateDocfile, so you do not need to call them directly.

Remarks

The following are the methods of the ILockBytes File-Based Implementation.

ILockBytes::ReadAt

Reads a block of bytes from a specified offset at the beginning of the byte-array.

ILockBytes::WriteAt

Writes a block of bytes from a specified offset at the beginning of the byte array.

ILockBytes::Flush

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

ILockBytes::SetSize

Sets the size of the byte array.

ILockBytes::LockRegion

The dwLockTypes parameter is set to LOCK_ONLYONCE or LOCK_EXCLUSIVE, which will allow or restrict access to locked regions.

ILockBytes::UnlockRegion

This method unlocks the region locked by ILockBytes::LockRegion.

ILockBytes::Stat

The COM-provided IStorage::Stat implementation calls the ILockBytes::Stat method to retrieve information about the byte array object. If there is no reasonable name for the byte array, the COM-provided ILockBytes::Stat method returns NULL in the pwcsName member of the STATSTG structure.

Related topics

ILockBytes
IStorage
IStream

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.