ISCardManage interface
[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
- 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.
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 |