|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This defines the interface of a privileged system class that represents a Card Holder Verification
Method. This class offers basic Cardholder Verification Method services (e.g. CVM verification, CVM
state interrogation) to any of the applications present on the card, while some of the services (e.g.
unblock CVM, change CVM value) are restricted to applications with the privilege to change the CVM
values. Prior to using this interface, an application is required to obtain a handle to the CVM
services by invoking the GPSystem.getCVM()
method.
Field Summary | |
static short |
CVM_FAILURE
The CVM value comparison failed. |
static short |
CVM_SUCCESS
The CVM value comparison was successful. |
static byte |
FORMAT_ASCII
The CVM value is formatted as ASCII bytes. |
static byte |
FORMAT_BCD
The CVM value is formatted as numerical digits, coded on a nibble (4 bits) and left justified. |
static byte |
FORMAT_HEX
The CVM value is formatted as hexadecimal (binary) data. |
Method Summary | |
boolean |
blockState()
This method sets the CVM state to BLOCKED. |
byte |
getTriesRemaining()
This method returns the number of tries remaining for the CVM. |
boolean |
isActive()
This method indicates whether the CVM is present and activated. |
boolean |
isBlocked()
This method indicates whether the CVM is currently BLOCKED. |
boolean |
isSubmitted()
This method indicates whether an attempt has been made to compare the CVM value. |
boolean |
isVerified()
This method indicates whether a successful comparison of the CVM value has occurred (CVM state of VALIDATED). |
boolean |
resetAndUnblockState()
This method resets the CVM state from BLOCKED to ACTIVE. |
boolean |
resetState()
This method resets the CVM state to ACTIVE. |
boolean |
setTryLimit(byte bTryLimit)
This method sets the maximum number of tries for the CVM. |
boolean |
update(byte[] babuffer,
short sOffset,
byte bLength,
byte bFormat)
This method changes the CVM value. |
short |
verify(byte[] baBuffer,
short sOffset,
byte bLength,
byte bFormat)
This method compares the stored CVM value with the one passed as parameter. |
Field Detail |
public static final short CVM_SUCCESS
public static final short CVM_FAILURE
public static final byte FORMAT_ASCII
Note:
public static final byte FORMAT_BCD
Note:
public static final byte FORMAT_HEX
Note:
Method Detail |
public boolean isActive()
true
if the CVM state is (at least) ACTIVE, false
otherwise.public boolean isSubmitted()
Note:
true
if the CVM state is (at least) SUBMITTED, false
otherwise.public boolean isVerified()
true
if the CVM state is VALIDATED, false
otherwise.public boolean isBlocked()
true
if the CVM state is BLOCKED, false
otherwise.public byte getTriesRemaining()
public boolean update(byte[] babuffer, short sOffset, byte bLength, byte bFormat)
Notes:
true
if the CVM value was changed, false
otherwise.public boolean resetState()
Notes:
true
if the CVM state was reset, false
otherwise.public boolean blockState()
true
if the CVM state was set to BLOCKED, false
otherwise.public boolean resetAndUnblockState()
Notes:
true
if the CVM state was reset to ACTIVE, false
otherwise.public boolean setTryLimit(byte bTryLimit)
Notes:
true
if the maximum number of tries was set, false
otherwise.public short verify(byte[] baBuffer, short sOffset, byte bLength, byte bFormat)
Notes:
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |