Gemalto Prox–DU Guide

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 22/129
SCardListInterfaces Function
The SCardListInterfaces function provides a list of interfaces supplied by a given card.
The caller supplies the name of a smart card previously introduced to the subsystem, and
receives the list of interfaces supported by the card.
Syntax:
LONG WINAPI SCardListInterfaces(
__in SCARDCONTEXT hContext,
__in LPCTSTR szCard,
__out LPGUID pguidInterfaces,
__inout LPDWORD pcguidInterfaces
);
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. This
parameter cannot be NULL.
szCard [in]
Name of the smart card already introduced to the smart card subsystem.
pguidInterfaces [out]
Array of interface identifiers (GUIDs) that indicate the interfaces supported by the
smart card. If this value is NULL, SCardListInterfaces ignores the array length
supplied in pcguidInterfaces, returning the size of the array that would have been
returned if this parameter had not been NULL to pcguidInterfaces and a success
code.
pcguidInterfaces [in, out]
Size of the pcguidInterfaces array, and receives the actual size of the returned
array. If the array size is specified as SCARD_AUTOALLOCATE, then
pcguidInterfaces is converted to a pointer to a GUID pointer, and receives the
address of a block of memory containing the array. This block of memory must be
deallocated with SCardFreeMemory.
Return Value:
This function returns different values depending on whether it succeeds or fails:
Success: SCARD_S_SUCCESS.
Failure: An error code. For more information, see Smart Card Return Values.
Remarks:
The SCardListInterfaces function is a database query function. For more information on
other database query functions, see Smart Card Database Query Functions.
Examples:
The following example shows listing the interfaces for a smart card.
LPGUID pGuids = NULL;
LONG lReturn;

Gemalto Prox–DU Specifications

General

Brand	Gemalto
Model	Prox–DU
Category	Card Reader
Language	English