IFillLockBytes::SetFillSize

This method sets the expected size of the byte array.

HRESULT SetFillSize(
  ULARGE_INTEGER uISize 
);

Parameters

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

Return Values

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.

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

Requirements

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

See Also

IFillLockBytes::FillAppend | IFillLockBytes::FillAt | ILockBytes::ReadAt

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.