ILockBytes::SetSize

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method changes the size of the byte array.

Syntax

HRESULT SetSize( 
  ULARGE_INTEGER cb 
);

Parameters

• cb
  [in] New size of the byte array as a number of bytes.

Return Value

The following table shows the return values for this method.

Remarks

ILockBytes::SetSize changes the size of the byte array.

If the cb parameter is larger than the current byte array, the byte array is extended to the indicated size by filling the intervening space with bytes of undefined value, as does the ILockBytes::WriteAt method, if the seek pointer is past the current end-of-stream.

If the cb parameter is smaller than the current byte array, the byte array is truncated to the indicated size.

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

Notes to Callers

Callers cannot rely on STG_E_MEDIUMFULL being returned at the appropriate time because of cache buffering in the operating system or network. However, callers must be able to deal with this return code because some ILockBytes interface implementations might support it.

Requirements