ISCardCmd::Encapsulate

The Encapsulate method encapsulates the given command APDU into another command APDU for transmission to a smart card.

HRESULT Encapsulate(
  LPBYTEBUFFER pApdu,
  ISO_APDU_TYPE ApduType
);

Parameters

pApdu
[in] Pointer to the APDU to be encapsulated.
ApduType
[in] Specifies the ISO 7816-4 case for T0 transmissions. Possible values are:

ISO_CASE_1

ISO_CASE_2

ISO_CASE_3

ISO_CASE_4

Return Values

The possible return values are the following:

Value Meaning
S_OK Public key retrieved successfully.
E_INVALIDARG Invalid parameter.
E_POINTER A bad pointer was passed in pApdu.
E_OUTOFMEMORY Out of memory.

Remarks

To build a command APDU, call BuildCmd.

For a list of all the methods provided by the ISCardCmd interface, see ISCardCmd.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scarddat.h.
  Import Library: scarddat.tlb.

See Also

BuildCmd, ISCardCmd