Enum EbicsSecurityMediumErrorCode

The EbicsSecurityMediumError provides more detail on the cause of an error returned through the IEbicsSecurityMedium interface.

Namespace: Subsembly.EBICS
Assembly: Subsembly.EBICS.Core.dll
Syntax
public enum EbicsSecurityMediumErrorCode
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.

Fields

Name Description
BadPIN

Indicates that the presented PIN was completely malformed and thus could not be verified at all.
BadSecurityMedia

Indicates 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

Indicates that the given SecurityMediaID is completely malformed and thus not understood by the given IEbicsSecurityMedium implementation.
BlockedSecurityMedium

Indicates that the security medium has been blocked and can no longer be used (0x6983).
Cancelled

The authentication was cancelled by the user.
MustChangePIN

The 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

An attempt for a secure authentication was made, but this is not a class 2 card reader device.
NoPIN

This security media does not have a PIN assigned, yet.
NoSecurityMedia

Indicates 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

Used 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

Indicates 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

Indicates 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.
See Also