ISCardDatabase::ListCardInterfaces

The ListCardInterfaces method retrieves the identifiers (GUIDs) of all the interfaces supported for the specified smart card.

HRESULT ListCardInterfaces(
  BSTR bstrCardName,                      
  LPSAFEARRAY *ppInterfaceGuids
);

Parameters

bstrCardName
[in] Name of the smart card.
ppInterfaceGuids
[out, retval] Pointer to the interface GUIDs if successful; NULL if operation failed.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDPARAMETER Invalid parameter.
E_POINTER A bad pointer was passed in ppInterfaceGuids.
E_OUTOFMEMORY Out of memory.

Remarks

To retrieve the primary service provider of the smart card, call GetProviderCardId.

To retrieve all known smart cards, readers, and reader groups call ListCard, ListReaders, and ListReaderGroups respectively.

For a list of all the methods provided by the ISCardDatabase interface, see ISCardDatabase.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardmgr.h.
  Import Library: scardmgr.tlb.

See Also

GetProviderCardId, ISCardDatabase, ListCards, ListReaderGroups, ListReaders