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.
To submit a transaction to a specific card
- Create an ISCardDatabase interface.
- Call ListCards to retrieve all the known smart cards based on an ATR string or their supported interfaces.
- 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.
| Method | Description |
|---|---|
| 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
| 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 |
| Header |
|
| Type library |
|
| DLL |
|
| IID |
IID_ISCardDatabase is defined as 1461AAC8-6810-11D0-918F-00AA00C18068 |