Share via


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(
  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 pguidInterfaces array; receives the actual size of the returned array.

Return Values

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

Remarks

SCardListInterfaces is a database query function.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Winscard.h.
Link Library: Winscard.lib.

See Also

SCardEstablishContext | SCardGetProviderId | SCardListCards | SCardListReaders

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.