SmartcardCreateLink
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |