ISCardTypeConv::ConvertByteBufferToSafeArray method

[The ConvertByteBufferToSafeArray 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, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]

The ConvertByteBufferToSafeArray method converts a universal buffer of bytes (IStream object) into a SAFEARRAY of unsigned char (byte).

Syntax

HRESULT ConvertByteBufferToSafeArray(
  [in]  LPBYTEBUFFER pbyBuffer,
  [out] LPSAFEARRAY  *ppbyArray
);

Parameters

pbyBuffer [in]

Pointer to the IStream object to be converted.

ppbyArray [out]

Pointer to the SAFEARRAY to be returned.

Return value

The method returns one of the following possible values:

Return code Description
S_OK
Memory allocated successfully.
E_INVALIDARG
There is something wrong with one or more of the parameters passed into the function.
E_POINTER
A parameter of pointer type was incorrect.
E_OUTOFMEMORY
Not enough free memory to satisfy request.

 

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
Scarddat.h
Type library
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardTypeConv is defined as 53B6AA63-3F56-11D0-916B-00AA00C18068

See also

ISCardTypeConv

Smart Card Return Values