SCardGetStatusChange
This function blocks execution until the current availability of the cards in a specific set of readers changes.
The caller supplies a list of readers to be monitored through an SCARD_READERSTATE array and the maximum amount of time, in seconds, that it is willing to wait for an action to occur on one of the listed readers. The function returns when there is a change in availability, having filled in the dwEventState members of the SCARD_READERSTATE ** structures appropriately.
LONG SCardGetStatusChange(
IN SCARDCONTEXT hContext,
IN DWORD dwTimeout,
IN OUT LPSCARD_READERSTATE rgReaderStates,
IN DWORD cReaders );
Parameters
- hContext
Handle to the resource manager context. The resource manager context is set by a previous call to SCardEstablishContext. - dwTimeout
Specifies the maximum amount of time, in milliseconds, to wait for an action. A value of 0 implies a value of INFINITE; dwTimeOut will never timeout. - rgReaderStates
Supplies an array of SCARD_READERSTATE structures that specify the readers to watch, and receives the result. - cReaders
Supplies the number of elements in the rgReaderStates array.
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
SCardGetStatusChange 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
SCardCancel, SCardEstablishContext, SCardLocateCards, SCARD_READERSTATE
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.