| Previous | Next |
| SCARD_W_EOF | SCARD_W_CARD_NOT_AUTHENTICATED |
SCARD_W_CANCELLED_BY_USER
Expected cancellation from user interaction
SCARD_W_CANCELLED_BY_USER means that the user cancelled a smart-card user-interface flow, such as a card-selection dialog. It should be handled as a deliberate outcome of an interactive operation, not as a defective card, reader, certificate, or PIN. In particular, it differs from SCARD_E_CANCELLED, which is associated with programmatic cancellation through SCardCancel.
Good callers preserve this distinction because it determines what the user sees next. Showing a hardware-error message after the user selected Cancel is misleading, while silently retrying can reopen a dialog the user explicitly dismissed.
Recommended behavior
- Return to the calling workflow with an explicit cancelled state and do not attempt a background reconnect.
- Separate user cancellation telemetry from reader and authentication failures.
- Use
SCardCancelonly for outstanding wait operations in the relevant resource-manager context; it is a different mechanism.
References
Looking for a different code? Search another status or error code.