IFillLockBytes::SetFillSize method (objidl.h)

The SetFillSize method sets the expected size of the byte array.

Syntax

HRESULT SetFillSize(
  [in] ULARGE_INTEGER ulSize
);

Parameters

[in] ulSize

Size in bytes of the byte array object that is to be filled in subsequent calls to IFillLockBytes::FillAppend.

Return value

This function supports the standard return values E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, and E_FAIL.

Remarks

If SetFillSize has not been called, any call to ILockBytes::ReadAt that attempts to access data that has not yet been written using IFillLockBytes::FillAppend or IFillLockBytes::FillAt will return a new error message, E_PENDING. After SetFillSize has been called, any call to ReadAt that attempts to access data beyond the current size, as set by SetFillSize, returns E_FAIL instead of E_PENDING.

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

IFillLockBytes::FillAppend

IFillLockBytes::FillAt

ILockBytes::ReadAt