IFillLockBytes::SetFillSize
A version of this page is also available for
4/8/2010
This method sets the expected size of the byte array.
Syntax
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 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.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IFillLockBytes::FillAppend
IFillLockBytes::FillAt
ILockBytes::ReadAt