IOCTL_SMARTCARD_IS_PRESENT
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
This code is used to wait for card insertion. The operation either returns immediately with STATUS_SUCCESS, which indicates that a card is already in the reader, or it blocks until a card is inserted.
Parameters
- dwOpenData
[in] Handle returned from a call to the smart card reader driver's XXX_Open (Device Manager) function.
- dwCode
[in] Specifies this code.
- pBufIn
Ignored.
- dwLenIn
Ignored.
- pBufOut
Ignored.
- dwLenOut
[out] Must be set to 0.
- pdwActualOut
[out] Must be set to 0.
Return Values
One of the following status values.
| Status | Description |
|---|---|
STATUS_SUCCESS |
There is a smart card in the card reader. |
STATUS_CANCELLED |
The card reader was closed or the IOCTL_SMARTCARD_CANCEL_BLOCKING code was issued. |
STATUS_DEVICE_BUSY |
Event tracking is already active. |
STATUS_INVALID_DEVICE_STATE |
The card reader cannot accept the request. |
Remarks
Smart card reader drivers return Windows NT status values, rather than Win32 error values, as the return values from the driver's callback function.
Requirements
| Header | winsmcrd.h |
| Windows Embedded CE | Windows CE 3.0 and later |