Gemalto Prox–DU Guide

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 33/129
SCardIntroduceCardType Function
The SCardIntroduceCardType function introduces a smart card to the smart card subsystem
(for the active user) by adding it to the smart card database.
Syntax:
LONG WINAPI SCardIntroduceCardType(
__in SCARDCONTEXT hContext,
__in LPCTSTR szCardName,
__in_opt LPCGUID pguidPrimaryProvider,
__in_opt LPCGUID rgguidInterfaces,
__in DWORD dwInterfaceCount,
__in LPCBYTE pbAtr,
__in LPCBYTE pbAtrMask,
__in DWORD cbAtrLen
);
Parameters:
hContext [in]
Handle that identifies the resource manager context. The resource manager context
is set by a previous call to SCardEstablishContext. This parameter cannot be NULL.
szCardName [in]
Name by which the user can recognize the card.
pguidPrimaryProvider [in, optional]
Pointer to the identifier (GUID) for the smart card's primary service provider.
rgguidInterfaces [in, optional]
Array of identifiers (GUIDs) that identify the interfaces supported by the smart card.
dwInterfaceCount [in]
Number of identifiers in the rgguidInterfaces array.
pbAtr [in]
ATR string that can be used for matching purposes when querying the smart card
database (for more information, see SCardListCards). The length of this string is
determined by normal ATR parsing.
pbAtrMask [in]
Optional bitmask to use when comparing the ATRs of smart cards to the ATR
supplied in pbAtr. If this value is non-NULL, it must point to a string of bytes the
same length as the ATR string supplied in pbAtr. When a given ATR string A is
compared to the ATR supplied in pbAtr, it matches if and only if A & M = pbAtr,
where M is the supplied mask, and & represents bitwise AND.
cbAtrLen [in]
Length of the ATR and optional ATR mask. If this value is zero, then the length of
the ATR is determined by normal ATR parsing. This value cannot be zero if a pbAtr
value is supplied.
Return Value:

Gemalto Prox–DU Specifications

General

Brand	Gemalto
Model	Prox–DU
Category	Card Reader
Language	English