Edit

ISCardManage interface

  • Article

[The ISCardManage interface no longer available for use as of Windows Server 2008, Windows Vista, and Windows Server 2003 with Service Pack 1 (SP1) and later. The Smart Card Modules provide similar functionality.]

The following interface definition is provided as a standard that can be followed when developing a smart card service provider.

The ISCardManage interface must be provided. It is used for attaching to a specific smart card or reader, for creating other optional interfaces to perform specific smart card functions, for locking a specific smart card for exclusive use, and for getting the status of a smart card or reader. As a set, these services can be responsible for maintaining a well-defined context within which an application can communicate with a smart card or reader.

Following is a typical use of ISCardManage interface.

To connect to a smart card

  1. Create the ISCardManage interface associated with the card.
  2. Connect to a smart card by attaching to a specific smart card reader (AttachByIFD) or by using a previously acquired handle (AttachByHandle).
  3. Create other interfaces to perform smart card operations (CreateCardAuth, CreateFileAccess, CreateCHVerification, or CreateInterface).
  4. Release the card (Detach).
  5. Release the ISCardManage interface and others as required.

Members

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

Methods

The ISCardManage interface has these methods.

Method Description
AttachByHandle Allows an application to create a communication link to a smart card using a handle returned by the smart card resource manager.
AttachByIFD Allows an application to request establishment of a context for a specific reader referenced with a display name.
CreateCardAuth Allows the creation of a ISCardAuth interface.
CreateCHVerification Allows the creation of a ISCardVerify interface.
CreateFileAccess Allows the creation of a ISCardFileAccess interface.
CreateInterface Allows the creation of an interface.
Detach Releases the attachment to a particular smart card or reader allocated by AttachByHandle or AttachByIFD respectively.
Reconnect Allows an application to reconnect to a smart card or reader without having to issue a Detach followed by AttachByHandle or AttachByIFD respectively.
SCardLock Locks a connected smart card or reader for exclusive use.
SCardUnlock Releases exclusive use of the connected smart card or reader.
Status Allows an application to get the current status of the smart card or reader.

 

Requirements

Requirement Value
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