SCardForgetReaderGroup

The SCardForgetReaderGroup function removes a previously introduced smart card reader group from the smart card subsystem. Although this function automatically clears all readers from the group, it does not affect the existence of the individual readers in the database.

LONG SCardForgetReaderGroup(
  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 of the reader group to be removed. System-defined reader groups cannot be removed from the database.

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

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

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, SCardForgetCardType, SCardForgetReader, SCardIntroduceReaderGroup