Gemalto Prox–DU Guide

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 29/129
SCardAddReaderToGroup Function
The SCardAddReaderToGroup function adds a reader to a reader group.
Syntax:
LONG WINAPI SCardAddReaderToGroup(
__in SCARDCONTEXT hContext,
__in LPCTSTR szReaderName,
__in LPCTSTR szGroupName
);
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.
szReaderName [in]
Display name of the reader that you are adding.
szGroupName [in]
Display name of the group to which you are adding the reader.
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:
SCardAddReaderToGroup automatically creates the reader group specified if it does not
already exist.
The SCardAddReaderToGroup function is a database management function. For more
information on other database management functions, see Smart Card Database
Management Functions.
Examples:
The following example demonstrates how to add a smart card reader to a group. The
example assumes that lReturn is an existing variable of type LONG, that hContext is a valid
handle received from a previous call to the SCardEstablishContext function, and that
"MyReader" and "MyReaderGroup" are known by the system through previous calls to the
SCardIntroduceReader and SCardIntroduceReaderGroup functions, respectively.
lReturn = SCardAddReaderToGroup( hContext,
L"MyReader",
L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardAddReaderToGroup\n");

Gemalto Prox–DU Specifications

General

Brand	Gemalto
Model	Prox–DU
Category	Card Reader
Language	English