SmartcardCreateLink (Windows Embedded CE 6.0)
1/6/2010
The SmartcardCreateLink function registers a friendly name that an application can use to access the smart card reader through the Smart Card Resource Manager.
Syntax
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 smart card reader name such as "SCR1:" for which the link should be created.
Return Value
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 Embedded CE drivers than it does for WDM or VxD drivers.
Requirements
| Header | smclib.h |
| Windows Embedded CE | Windows CE 3.0 and later |