SCardIntroduceReader

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

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

Parameters

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

Return Values

Value Description
Succeeds SCARD_S_SUCCESS
Fails An error value (see Smart Card Error values for a list of all error values)

Remarks

SCardIntroduceReader is a database management function.

To remove a reader, see SCardForgetReader.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later Winscard.h   Winscard.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

SCardEstablishContext, SCardIntroduceCardType, SCardForgetReader

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.