[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 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
- Create the ISCardManage interface associated with the card.
- Connect to a smart card by attaching to a specific smart card reader (AttachByIFD) or by using a previously acquired handle (AttachByHandle).
- Create other interfaces to perform smart card operations (CreateCardAuth, CreateFileAccess, CreateCHVerification, or CreateInterface).
- Release the card (Detach).
- Release the ISCardManage interface and others as required.
The ISCardManage interface inherits from the IDispatch interface. ISCardManage also has these types of members:
The ISCardManage interface has these methods.
|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.
|Minimum supported client
||Windows XP [desktop apps only]
|Minimum supported server
||Windows Server 2003 [desktop apps only]
|End of client support
|End of server support
||Windows Server 2003