ISCardDatabase::ListReaders

The ListReaders method retrieves the names of the smart card readers registered in the smart card database.

HRESULT ListReaders(
  LONG localeId,  
  LPSAFEARRAY *ppReaders
);

Parameters

localeId
[in, lcid, defaultvalue(0x0409)] Language localization ID.
ppReaders
[out, retval] Pointer to a SAFEARRAY of BSTRs that contains the names of the smart card readers if successful; NULL if the 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 ppReaders.
E_OUTOFMEMORY Out of memory.

Remarks

To retrieve all known smart cards or reader groups, call ListCards or ListReaderGroups respectively.

To retrieve the primary service provider or the interfaces of a specific card GetProviderCardId or ListCardInterfaces 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, ListCardInterfaces, ListCards, ListReaderGroups