Share via


SmartcardCreateLink (Windows CE 5.0)

Send Feedback

The SmartcardCreateLink function registers a friendly name that an application can use to access the device through the smart card resource manager.

NTSTATUS SmartcardCreateLink(LPCWSTR pszFriendlyName,LPCWSTR pszDeviceName);

Parameters

  • pszFriendlyName
    [in] Points to a displayable friendly name. The driver should preferably provide a combination of the reader product name and the device number such as "XYZ Reader [1]".
  • pszDeviceName
    [in] Points to the existing device name such as "PSC1:" for which the link should be created.

Return Values

This function returns an NTSTATUS value. Possible values are the following.

Value Description
STATUS_SUCCESS A protocol was successfully selected.
STATUS_NO_MEDIA No card is in the reader.
STATUS_IO_TIMEOUT The request has timed out.
STATUS_BUFFER_TOO_SMALL The user buffer is not large enough to hold a ULONG.
STATUS_INVALID_DEVICE_STATE The reader is not in the correct state to select a protocol. This is the case when a card is inserted, but not reset.
STATUS_INVALID_DEVICE_REQUEST The mask contains an unknown protocol.

Remarks

SmartcardCreateLink is platform-specific and performs a different action for Windows CE drivers than it does for WDM or VxD drivers.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Smclib.h.

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.