SCardListInterfaces

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.

LONG SCardListInterfaces(
IN SCARDCONTEXT hContext, 
IN LPCTSTR szCard, 
OUT LPGUID pguidInterfaces, 
IN OUT LPDWORD pcguidInterfaces );

Parameters

• hContext
  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
  Null-terminated string to the name of the smart card already introduced to the smart card subsystem.
• pguidInterfaces
  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
  Pointer to the size of the pguidInterfaces array; receives the actual size of the returned array.

Return Values

Remarks

SCardListInterfaces is a database query function.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

SCardEstablishContext, SCardGetProviderId, SCardListCards, SCardListReaders

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.