Share via


SCardIntroduceReader

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function introduces a new name for an existing smart card reader. Smart card readers are automatically introduced to the system.

Syntax

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

Parameters

  • hContext
    [in] Handle to the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.
  • szReaderName
    [in] Null-terminated string that contains the friendly name to be assigned to the reader.
  • szDeviceName
    [in] Null-terminated string that contains the system name of the smart card reader device. For example, "SCR1:".

Return Value

The following table shows the possible return values.

Value Description

SCARD_S_SUCCESS

Succeeds

An error value (see Smart Card Error Values for a list of all error values).

Fails

Remarks

SCardIntroduceReader is a database management function.

To remove a reader, see SCardForgetReader.

Requirements

Header winscard.h
Library winscard.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

SCardEstablishContext
SCardIntroduceCardType
SCardForgetReader