|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
The RDF_CARD_POWERcallback function resets or powers down an inserted smart card. This callback function is mandatory.
NTSTATUS (*ReaderFunction[RDF_CARD_POWER])( PSMARTCARD_EXTENSION SmartcardExtension );
|SCARD_COLD_RESET||Performs a cold reset of the card.|
|SCARD_WARM_RESET||Performs a warm reset of the card.|
|SCARD_POWER_DOWN||Switches off card power.|
SmartcardExtension->IoRequest.ReplyBufferLengthmust be set to the length of the reply buffer. When the callback function returns, SmartcardExtension->IoRequest.ReplyBufferwill contain the ATR returned by the card. In addition, you must transfer the ATR to SmartcardExtension->CardCapabilities.ATR.Bufferto let the library parse the ATR . SmartcardExtension->IoRequest.Informationreceives the actual length of the ATR. In addition you must transfer the length of the ATR to SmartcardExtension->CardCapabilities.ATR.Length.
This function returns an NTSTATUS value. Possible values are the following.
|STATUS_SUCCESS||Function successfully executed.|
|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 the ATR.|
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||3.0 and later|
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.
Last updated on Tuesday, July 13, 2004