IByteBuffer::Initialize method

[The Initialize method is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later. The IStream interface provides similar functionality.]

The Initialize method prepares the IByteBuffer object for use. This method must be called prior to calling any other methods in the IByteBuffer interface.

Syntax

HRESULT Initialize(
  [in] LONG lSize,
  [in] BYTE *pData
);

Parameters

lSize [in]

Initial size, in bytes, of the data the stream is to contain.

pData [in]

If not NULL, the initial data to write to the stream.

Return value

The return value is an HRESULT. A value of S_OK indicates the call was successful.

Remarks

When using a new IByteBuffer stream, call this method prior to using any of the other IByteBuffer methods.

Examples

The following example shows initializing the IByteBuffer object.

UCHAR    ucFileName[] = {0x3f, 0x00};    // Master File (MF)
HRESULT  hr;

// pIByteRequest is a pointer to an instantiated IByteBuffer object.
hr = pIByteRequest->Initialize(2, ucFileName);
if (FAILED(hr))
    printf("Failed IByteBuffer::Initialize\n");

Requirements