Reads a specified number of bytes starting at a specified offset from the beginning of the byte array object.
HRESULT ReadAt(
ULARGE_INTEGER ulOffset,
//Specifies the starting point for reading data
void *pv, //Points to the buffer into which the data is read
ULONG cb, //Specifies the number of bytes to read
ULONG *pcbRead
//Pointer to location that contains actual number of
//bytes read
);
ILockBytes::ReadAt reads bytes from the byte array object. It reports the number of bytes that were actually read. This value may be less than the number of bytes requested if an error occurs or if the end of the byte array is reached during the read.
It is not an error to read less than the specified number of bytes if the operation encounters the end of the byte array. Note that this is the same end-of-file behavior as found in MS-DOS FAT file system files.
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in objidl.h.
ILockBytes::WriteAt, ILockBytes—File-Based Implementation, ILockBytes—Global Memory Implementation