Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Smartcard Library FunctionsIFDHPowerICC(3SMARTCARD)


NAME

 IFDHPowerICC - power up or power down the smart card

SYNOPSIS

 
#include <smartcard/ifdhandler.h>
RESPONSECODE IFDHPowerICC(DWORD Lun, DWORD Action, PUCHAR Atr, PDWORD AtrLength);

PARAMETERS

 

The IFDHPowerICC() takes the following parameters:

Input

 
Lun
Logical Unit Number
Action
Action to be taken
AtrLength
Maximum length of the ATR

Output

 
Atr
Answer to Reset (ATR) value of the inserted card
AtrLength
Actual length of the ATR

DESCRIPTION

 

The IFDHPowerICC() function controls the power and reset signals of the ICC (smart card) at the reader or slot specified by Lun. The Action parameter can take one of the following values:

IFD_POWER_UP
Power and reset the card. Return the ATR and its length.
IFD_POWER_DOWN
Power down the card. The Atr and AtrLength parameters are set to 0.
IFD_RESET
Perform a quick reset on the card. Return the ATR and its length.

The IFD handler caches the ATR during a power up or reset and returns the ATR and its length in a call to IFDHGetCapabilities(3SMARTCARD).

Memory cards without an ATR return IFD_SUCCESS on power up or reset but Atr and AtrLength are set to 0.


RETURN VALUES

 

The following values are returned:

IFD_SUCCESS
Successful completion.
IFD_ERROR_POWER_ACTION
An error occurred while powering up or resetting the card.
IFD_NOT_SUPPORTED
The action specified by Action is not supported.
IFD_COMMUNICATION_ERROR
An error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityEvolving

SEE ALSO

 

IFDHCreateChannelByName(3SMARTCARD), IFDHGetCapabilities(3SMARTCARD), attributes(5)


NOTES

 

This manual page is derived from the MUSCLE PC/SC IFD Driver Developer Kit documentation. License terms and attribution and copyright information for this interface are available at the default location /var/sadm/pkg/SUNWocfh/install/copyright. If the Solaris Operating Environment has been installed anywhere other than the default location, modify the path to access the file at the installed location.



SunOS 5.9Go To TopLast Changed 4 Dec 2002