[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 |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
