SCardIntroduceReaderGroup

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.

LONG SCardIntroduceReaderGroup(
  IN SCARDCONTEXT hContext,  
  IN LPCTSTR szGroupName  
);

Parameters

hContext
Supplies the handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.
szGroupName
Supplies the friendly name to be assigned to the new reader group.

Return Values

If the function… The return value is…
Succeeds SCARD_S_SUCCESS.
Fails An error code (see Error Codes for a list of all error codes).

Remarks

SCardIntroduceReaderGroup is a database management function. For a description of other database management functions, see Smart Card Database Management Functions.

To remove a reader group, see SCardForgetReaderGroup.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in winscard.h.
  Import Library: Link with winscard.lib.

See Also

SCardEstablishContext, SCardIntroduceCardType, SCardIntroduceReader, SCardForgetReaderGroup