SmartcardCreateLink (Windows CE 5.0)
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