Microsoft Windows CE 3.0  

RDF_CARD_POWER

Important:
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
);

Parameters

SmartcardExtension
Points to the smart card extension of the device. SmartcardExtension->MajorIoControlCodemust be set to IOCTL_SMARTCARD_POWER. SmartcardExtension->MinorIoControlCodemust contain one of the following minor codes, depending on the function to be performed:
Minor Code Meaning
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.

Return Values

This function returns an NTSTATUS value. Possible values are the following.

Value Meaning
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.

Requirements

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

© 2004 Microsoft Corporation. All rights reserved.