IByteBuffer::Initialize method

Article
01/07/2021

[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

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Header	Scardssp.h
Type library	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer is defined as E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Share via