SCardRemoveReaderFromGroup

The SCardRemoveReaderFromGroup function removes a reader from an existing reader group. This function has no affect on the reader or reader group.

LONG SCardRemoveReaderFromGroup(
  IN SCARDCONTEXT hContext,  
  IN LPCTSTR szReaderName,  
  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.
szReaderName
Supplies the friendly name of the reader to be removed.
szGroupName
Supplies the friendly name of the group from which the reader should be removed.

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

When the last reader is removed from a group, the group is automatically deleted.

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

To add a reader to a reader group, see SCardAddReaderToGroup.

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, SCardAddReaderToGroup, SCardForgetCardType, SCardForgetReader, SCardForgetReaderGroup