SCardCancel
This function terminates all outstanding actions within a specific resource manager context.
The only requests that you can cancel are those that require waiting for external action by the smart card or user. Any such outstanding action requests will terminate with a status indication that the action was canceled. This is especially useful to force outstanding SCardGetStatusChange calls to terminate.
LONG SCardCancel(
IN SCARDCONTEXT hContext );
Parameters
- hContext
Handle that identifies the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext.
Return Values
| Value | Description |
|---|---|
| Succeeds | SCARD_S_SUCCESS |
| Fails | An error value (see Smart Card Error values for a list of all error values) |
Remarks
SCardCancel is a smart card tracking function.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 3.0 and later | Winscard.h | Winscard.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
SCardEstablishContext, SCardGetStatusChange, SCardLocateCards
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.