Gemalto Prox–DU Guide

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 20/129
SCardListCards Function
The SCardListCards function searches the smart card database and provides a list of
named cards previously introduced to the system by the user.
The caller specifies an ATR string, a set of interface identifiers (GUIDs), or both. If both an
ATR string and an identifier array are supplied, the cards returned will match the ATR string
supplied and support the interfaces specified.
Syntax:
LONG WINAPI SCardListCards(
__in SCARDCONTEXT hContext,
__in_opt LPCBYTE pbAtr,
__in LPCGUID rgguidInterfaces,
__in DWORD cguidInterfaceCount,
__out LPTSTR mszCards,
__inout LPDWORD pcchCards
);
Parameters:
hContext [in]
Handle that identifies the resource manager context for the query. The resource
manager context can be set by a previous call to SCardEstablishContext.
pbAtr [in, optional]
Address of an ATR string to compare to known cards, or NULL if no ATR matching
is to be performed.
rgguidInterfaces [in]
Array of identifiers (GUIDs), or NULL if no interface matching is to be performed.
When an array is supplied, a card name will be returned only if all the specified
identifiers are supported by the card.
cguidInterfaceCount [in]
Number of entries in the rgguidInterfaces array. If rgguidInterfaces is NULL, then
this value is ignored.
mszCards [out]
Multi-string that lists the smart cards found. If this value is NULL, SCardListCards
ignores the buffer length supplied in pcchCards, returning the length of the buffer
that would have been returned if this parameter had not been NULL to pcchCards
and a success code.
pcchCards [in, out]
Length of the mszCards buffer in characters. Receives the actual length of the
multi-string structure, including all trailing null characters. If the buffer length is
specified as SCARD_AUTOALLOCATE, then mszCards is converted to a pointer to
a byte pointer, and receives the address of a block of memory containing the multi-
string structure. This block of memory must be deallocated with SCardFreeMemory.
Return Value:
This function returns different values depending on whether it succeeds or fails:

Gemalto Prox–DU Specifications

General

Brand	Gemalto
Model	Prox–DU
Category	Card Reader
Language	English