ISCardCmd::get_P3

The get_P3 method retrieves the third parameter (P3) byte from the APDU. This read-only byte value represents the size of the data portion of the APDU.

HRESULT get_P3(
  BYTE *pbyP3  
);
 

Parameters

pbyP3
[out, retval] Pointer to the byte that is the P3 from the APDU on return.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG pbyP3 is invalid.
E_POINTER A bad pointer was passed in pbyP3.
E_OUTOFMEMORY Out of memory.

Remarks

The P3 parameter is read only, and therefore cannot be set.

To get the P1 or P2 parameters, call get_P1 and get_P2 respectively.

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

get_P1, get_P2, ISCardCmd