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.

Aa376191.wedge(en-us,VS.85).gifTo 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.

MethodDescription
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

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

 

 

Show: