PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 38/129
SCardRemoveReaderFromGroup Function
The SCardRemoveReaderFromGroup function removes a reader from an existing reader
group. This function has no effect on the reader.
Syntax:
LONG WINAPI SCardRemoveReaderFromGroup(
__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 to be removed.
szGroupName [in]
Display name of the group from which the reader should be removed.
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:
When the last reader is removed from a group, the group is automatically forgotten.
The SCardRemoveReaderFromGroup function is a database management function. For
information about other database management functions, see Smart Card Database
Management Functions.
To add a reader to a reader group, use SCardAddReaderToGroup.
Examples:
The following example shows how to remove a reader from the group.
// Remove a reader from the group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
// The group is automatically forgotten if no readers remain in it.
lReturn = SCardRemoveReaderFromGroup(hContext,
L"MyReader",
L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardRemoveReaderFromGroup\n");