SCardListInterfaces (Windows CE 5.0)
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(SCARDCONTEXThContext, LPCTSTRszCard, LPGUIDpguidInterfaces, LPDWORDpcguidInterfaces);
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 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
Send Feedback on this topic to the authors