PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 30/129
SCardForgetCardType Function
The SCardForgetCardType function removes an introduced smart card from the smart card
subsystem.
Syntax:
LONG WINAPI SCardForgetCardType(
__in SCARDCONTEXT hContext,
__in LPCTSTR szCardName
);
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]
Display name of the card to be removed from the smart card database.
Return Value:
This function returns different values depending on whether it succeeds or fails:
Success: SCARD_S_SUCCESS.
Failure: An error code. For more information, see Smart Card Return Values.
Remarks:
The SCardForgetCardType function is a database management function. For more
information on other database management functions, see Smart Card Database
Management Functions.
Examples:
The following example removes the specified card type from the system. The example
assumes that lReturn is a valid variable of type LONG, that hContext is a valid handle
received from a previous call to the SCardEstablishContext function, and that
"MyCardName" was previously introduced by a call to the SCardIntroduceCardType
function.
lReturn = SCardForgetCardType(hContext,
L"MyCardName");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetCardType\n");