ISCardCmd::BuildCmd

The BuildCmd method constructs a valid command APDU for transmission to a smart card.

HRESULT BuildCmd(
  BYTE byClassId,
  BYTE byInsId,
  BYTE byP1,
  BYTE byP2,
  LPBYTEBUFFER pbyData,
  LONG *p1Le
);

Parameters

byClassId
[in] Command class identifier.
byInsId
[in] Command instruction identifier.
byP1
[in, defaultvalue(0)] Command's first parameter.
byP2
[in, defaultvalue(0)] Command's second parameter.
pbyData
[in, defaultvalue(NULL)] Pointer to the data portion of the command.
p1Le
[in, defaultvalue(NULL)] Pointer to a LONG integer containing the expected length of the returned data.

Return Values

The possible return values are the following:

Value Meaning
S_OK Public key retrieved successfully.
E_INVALIDARG One of the parameters are Invalid.
E_POINTER A bad pointer was passed in.
E_OUTOFMEMORY Out of memory.

Remarks

To encapsulate the command into another command, call Encapsulate

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

Encapsulate, ISCardCmd