ISCardLocate interface

[The ISCardLocate 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 ISCardLocate interface provides services for locating a smart card by its name.

This interface can display the smart card user interface if it is required.

The following scenario shows a typical use of the ISCardLocate interface. The ISCardLocate interface is used to build an application protocol data unit (APDU).

To locate a specific card using its name

  1. Create an ISCardLocate interface.
  2. Call ConfigureCardNameSearch to search for a smart card name.
  3. Call FindCard to search for the smart card.
  4. Interpret the results.
  5. Release the ISCardLocate interface.

Members

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

Methods

The ISCardLocate interface has these methods.

Method Description
ConfigureCardGuidSearch Reserved for future use.
ConfigureCardNameSearch Specifies the card name to be used in the search.
FindCard Searches for the smart card and opens a valid connection to it.

 

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
Scardmgr.h
Type library
Scardmgr.tlb
DLL
Scardssp.dll
IID
IID_ISCardLocate is defined as 1461AACD-6810-11D0-918F-00AA00C18068