ILockBytes::WriteAt method (objidl.h)

The WriteAt method writes the specified number of bytes starting at a specified offset from the beginning of the byte array.

Syntax

HRESULT WriteAt(
  [in]  ULARGE_INTEGER ulOffset,
  [in]  const void     *pv,
  [in]  ULONG          cb,
  [out] ULONG          *pcbWritten
);

Parameters

[in] ulOffset

Specifies the starting point from the beginning of the byte array for the data to be written.

[in] pv

Pointer to the buffer containing the data to be written.

[in] cb

Specifies the number of bytes of data to attempt to write into the byte array.

[out] pcbWritten

Pointer to a location where this method specifies the actual number of bytes written to the byte array. You can set this pointer to NULL to indicate that you are not interested in this value. In this case, this method does not provide the actual number of bytes written.

Return value

This method can return one of these values.

Remarks

ILockBytes::WriteAt writes the specified data at the specified location in the byte array. The number of bytes actually written must always be returned in pcbWritten, even if an error is returned. If the byte count is zero bytes, the write operation has no effect.

If ulOffset is past the end of the byte array and cb is greater than zero, ILockBytes::WriteAt increases the size of the byte array. The fill bytes written to the byte array are not initialized to any particular value.

Requirements

See also

ILockBytes - File-Based Implementation

ILockBytes - Global Memory Implementation

ILockBytes::ReadAt

ILockBytes::SetSize