SCardListInterfaces

A version of this page is also available for

4/8/2010

This function provides a list of interfaces supplied by a specified 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 SCardListInterfaces(
  SCARDCONTEXT hContext, 
  LPCTSTR szCard, 
  LPGUID pguidInterfaces, 
  LPDWORD pcguidInterfaces 
);

hContext
[in] Handle to the resource manager context for the query. The resource manager context can be set by a previous call to SCardEstablishContext or set to NULL if the query is not directed toward a specific context.

szCard
[in] Null-terminated string to the name of the smart card already introduced to the smart card subsystem.

pguidInterfaces
[out] Pointer to an array of globally unique 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] Pointer to the size of the pcguidInterfaces array, and receives the actual size of the returned array. If the array size is specified as SCARD_AUTOALLOCATE, 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.

The following table shows the possible return values.

Value	Description
SCARD_S_SUCCESS	Succeeds
An error value (see Smart Card Error Values for a list of all error values).	Fails

SCardListInterfaces is a database query function.

Header	winscard.h
Library	winscard.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later