SCardIntroduceReader

The SCardIntroduceReader function introduces a new name for an existing smart card reader.

Note Smart card readers are automatically introduced to the system.

LONG SCardIntroduceReader(
  IN SCARDCONTEXT hContext,
  IN LPCTSTR szReaderName,
  IN LPCTSTR szDeviceName
);

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 to be assigned to the reader.
szDeviceName
Supplies the system name of the smart card reader device. For example, "SCReader0".

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

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

To remove a reader, see SCardForgetReader.

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