Enum EbicsSecurityMediumErrorCode
The EbicsSecurityMediumError provides more detail on the cause of an error returned through the IEbicsSecurityMedium interface.
public enum EbicsSecurityMediumErrorCodeFields
BadPIN = -7Indicates that the presented PIN was completely malformed and thus could not be verified at all.
BadSecurityMedia = -3Indicates that the security medium is broken.
For a file based security medium this means that the file could not be loaded, or the contents of the file are corrupted.
For a smart card based security medium this means that some card command failed completely.
BadSecurityMediaID = -1Indicates that the given SecurityMediaID is completely malformed and thus not understood by the given IEbicsSecurityMedium implementation.
BlockedSecurityMedium = 27011Indicates that the security medium has been blocked and can no longer be used (0x6983).
Cancelled = -1000The authentication was cancelled by the user.
MustChangePIN = -8The PIN must be changed now. Usually this is because the given PIN is just a transport PIN that needs to be changed by the user.
NoClass2 = -9An attempt for a secure authentication was made, but this is not a class 2 card reader device.
NoPIN = -6This security media does not have a PIN assigned, yet.
NoSecurityMedia = -2Indicates that the identified security media is not available.
For a file based security media this means that the file identified by the given SecurityMediaID does not exist. For a smart card based security this means that no smart card is inserted.
Success = 0Used to indicate success, when an explicit success indication is needed. Note that for smart cards success can also be indicated by the value 0x9000 or other, similar values.
WrongPIN = -5Indicates that the presented PIN was wrong and there are either more than 15 tries left, or the number of remaining tries is not known.
WrongSecurityMedia = -4Indicates that the identified security media is not an appropriate security media for the given IEbicsSecurityMedium implementation.
For a file based security media this means that the file identified by the given SecurityMediaID appears not to be a key file at all.
For a smart card based security this means that the inserted smart card is not of the expected type or its serial number does not match the requested security media ID.
Remarks
In addition to the enumerated values, any smart card status word as defined in ISO 7816 part 4 may be used. In particular the values 0x63C0 through 0x63CF are used to indicate a failed PIN verification. The least significant nibble of this value provides the number of remaining verification attempts before the security token will be blocked.