Skip to content

SCARDCONTOL.md

Latest commit

 

History

History
68 lines (48 loc) · 2.05 KB

SCARDCONTOL.md

File metadata and controls

68 lines (48 loc) · 2.05 KB

List of SCardControl() commands supported by the CCID driver

PC/SC provides the SCardControl() function to send commands to the driver and/or reader. Here is the list of supported commands by this CCID driver.

PC/SC function prototype

See also SCardControl() in the pcsclite API documentation.

LONG SCardControl(
    SCARDHANDLE hCard,
    DWORD       dwControlCode,
    LPCVOID     pbSendBuffer,
    DWORD       cbSendLength,
    LPVOID      pbRecvBuffer,
    DWORD       cbRecvLength,
    LPDWORD     lpBytesReturned
)

Parameters:

  • [in] hCard Connection made from SCardConnect().
  • [in] dwControlCode Control code for the operation.
  • [in] pbSendBuffer Command to send to the reader.
  • [in] cbSendLength Length of the command.
  • [out] pbRecvBuffer Response from the reader.
  • [in] cbRecvLength Length of the response buffer.
  • [out] lpBytesReturned Length of the response.

If the dwControlCode is not supported the application receives the error SCARD_E_UNSUPPORTED_FEATURE or SCARD_E_NOT_TRANSACTED as a general error code.

supported ControlCode values

  • IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE

    defined as SCARD_CTL_CODE(1)

    The pbSendBuffer[] buffer is sent as a PC_to_RDR_Escape CCID command

    For security possible problems this command in possible in the following cases only:

    • the reader is a Gemalto (ex Gemplus) reader and the command is:
      • get firmware version
      • switch interface on a ProxDU
    • the ifdDriverOptions (in the Info.plist file) has the bit DRIVER_OPTION_CCID_EXCHANGE_AUTHORIZED set

  • CM_IOCTL_GET_FEATURE_REQUEST

    defined as SCARD_CTL_CODE(3400)

    Implements the PC/SC v2.02.08 Part 10 IOCTL mechanism

  • IOCTL_FEATURE_VERIFY_PIN_DIRECT

  • IOCTL_FEATURE_MODIFY_PIN_DIRECT

  • IOCTL_FEATURE_IFD_PIN_PROPERTIES

  • IOCTL_FEATURE_MCT_READERDIRECT

  • IOCTL_FEATURE_GET_TLV_PROPERTIES

    See PC/SC v2.02.08 Part 10