Gemalto Prox–DU Guide

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 37/129
SCardIntroduceReaderGroup Function
The SCardIntroduceReaderGroup function introduces a reader group to the smart card
subsystem. However, the reader group is not created until the group is specified when
adding a reader to the smart card database.
Syntax:
LONG WINAPI SCardIntroduceReaderGroup(
__in SCARDCONTEXT hContext,
__in LPCTSTR szGroupName
);
Parameters:
hContext [in]
Supplies the handle that identifies the resource manager context. The resource
manager context is set by a previous call to the SCardEstablishContext function. If
this parameter is NULL, the scope of the resource manager is
SCARD_SCOPE_SYSTEM.
szGroupName [in]
Supplies the display name to be assigned to the new reader group.
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 SCardIntroduceReaderGroup function is provided for PC/SC specification compatibility.
Reader groups are not stored until a reader is added to the group.
The SCardIntroduceReaderGroup function is a database management function. For a
description of other database management functions, see Smart Card Database
Management Functions.
To remove a reader group, use SCardForgetReaderGroup.
Examples:
The following example shows introducing a smart card reader group.
// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext,
L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardIntroduceReaderGroup\n");

Gemalto Prox–DU Specifications

General

Brand	Gemalto
Model	Prox–DU
Category	Card Reader
Language	English