SCardForgetReader

The SCardForgetReader function removes a previously introduced reader from control by the smart card subsystem. It is removed from the smart card database, including from any reader group that it may have been added to.

LONG SCardForgetReader(
  IN SCARDCONTEXT hContext,  
  IN LPCTSTR szReaderName  
);
 

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 from the smart card 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

SCardForgetReader 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, SCardForgetReaderGroup, SCardIntroduceReader