ISCardISO7816 interface

[The ISCardISO7816 interface 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 ISCardISO7816 interface provides methods for implementing ISO 7816-4 functionality. With the exception of SetDefaultClassId, these methods create an application protocol data unit (APDU) command that is encapsulated in a ISCardCmd object.

The ISO 7816-4 specification defines standard commands available on smart cards. The specification also defines how a smart card APDU command should be constructed and sent to the smart card for execution. This interface automates the building process.

The following example shows a typical use of the ISCardISO7816 interface. In this case, the ISCardISO7816 interface is used to build an APDU command.

Aa376169.wedge(en-us,VS.85).gifTo submit a transaction to a specific card

  1. Create an ISCardISO7816 and ISCardCmd interface.

    The ISCardCmd interface is used to encapsulate the APDU.

  2. Call the appropriate method of the ISCardISO7816 interface, passing the required parameters and the ISCardCmd interface pointer.

    The ISO 7816-4 APDU command will be built and encapsulated in the ISCardCmd interface.

  3. Release the ISCardISO7816 and ISCardCmd interfaces.
Note  In the method reference pages, if a bit sequence in a table is not defined, assume that bit sequence is reserved for future use or proprietary to a specific vendor.
 

Members

The ISCardISO7816 interface inherits from the IDispatch interface. ISCardISO7816 also has these types of members:

Methods

The ISCardISO7816 interface has these methods.

MethodDescription
AppendRecord

Constructs a command that appends a record to the end of an elementary file (EF).

EraseBinary

Sets part of the content of an EF to its logical erased state, sequentially, starting from a given offset.

ExternalAuthenticate

Conditionally updates the security status using the result of the computation by the card, based on a challenge previously issued by the card (for example, by the INS_GET_CHALLENGE command), a possibly secret key stored in the card, and authentication data transmitted by the interface device.

GetChallenge

Requires the issuing of a challenge for use in a security-related procedure.

GetData

Retrieves a single primitive data object or a set of data objects contained in a constructed data object, based on the type of file specified.

GetResponse

Transmits from the card to the interface device APDUs that otherwise could not be transmitted by the available protocols.

InternalAuthenticate

Initiates the computation of the authentication data by the card using the challenge data sent from the interface device and a relevant secret stored in the card.

ManageChannel

Opens and closes logical channels.

PutData

Stores one primitive data object, or one or more data objects contained in a constructed data object, within the current resource manager context.

ReadBinary

Constructs a command that acquires a response message that gives that part of the contents of an EF with transparent structure.

ReadRecord

Constructs a command that reads the contents of the specified records of an elementary file.

SelectFile

Sets a current file within a logical channel.

SetDefaultClassId

Assigns a standard class ID byte that will be used in all operations when constructing an ISO 7816-4 command APDU.

UpdateBinary

Initiates the update of the bits already present in an EF with the bits given in the command APDU.

UpdateRecord

Constructs a command that initiates the updating of a specific record.

Verify

Initiates the comparison in the card of the verification data sent from the interface device with the reference data stored in the card.

WriteBinary

Initiates the writing of binary values into an EF.

WriteRecord

Constructs a command that writes a record.

 

Requirements

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

Scardssp.h

Type library

Scardsrv.tlb

DLL

Scardssp.dll

IID

IID_ISCardISO7816 is defined as 53B6AA68-3F56-11D0-916B-00AA00C18068

 

 

Show: