SCardListInterfaces

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 
);

Parameters

• 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.

Return Value

The following table shows the possible return values.

Remarks

SCardListInterfaces is a database query function.

Requirements

See Also

Reference

SCardEstablishContext
SCardGetProviderId
SCardListCards
SCardListReaders