ISCardDatabase interface

[The ISCardDatabase 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 ISCardDatabase interface provides the methods for performing the smart card resource manager's database operations. These operations include listing known smart cards, readers, and reader groups, plus retrieving the interfaces supported by a smart card and its primary service provider.

Note  The identifier of the primary service provider is a COM GUID that can be used to instantiate and use the COM objects for a specific card.
 

The following example shows a typical use of the ISCardDatabase interface. In this case, the ISCardDatabase interface is used to list all the known smart cards.

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

  1. Create an ISCardDatabase interface.
  2. Call ListCards to retrieve all the known smart cards based on an ATR string or their supported interfaces.
  3. Release the ISCardDatabase interface.

Members

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

Methods

The ISCardDatabase interface has these methods.

MethodDescription
GetProviderCardId

Retrieves the identifier of the primary service provider for a specific smart card.

ListCardInterfaces

Retrieves the interface identifiers (GUIDs) of all the interfaces supported by a specific smart card.

ListCards

Retrieves all the smart card names that match a specific set of interface identifiers (GUIDs) or an ATR string.

ListReaderGroups

Retrieves the names of the reader groups that the resource manager has knowledge of.

ListReaders

Retrieve the names of the readers of which the resource manager has knowledge.

 

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

Scardmgr.h

Type library

Scardmgr.tlb

DLL

Scardssp.dll

IID

IID_ISCardDatabase is defined as 1461AAC8-6810-11D0-918F-00AA00C18068

 

 

Show: