iaik.pkcs.pkcs11.wrapper

Class PKCS11Exception

java.lang.Object

java.lang.Throwable

java.lang.Exception

iaik.pkcs.pkcs11.TokenException

iaik.pkcs.pkcs11.wrapper.PKCS11Exception

All Implemented Interfaces:

Serializable

public class PKCS11Exception
extends TokenException

This is the superclass of all checked exceptions used by this package. An exception of this class indicates that a function call to the underlying PKCS#11 module returned a value not equal to CKR_OK. The application can get the returned value by calling getErrorCode(). A return value not equal to CKR_OK is the only reason for such an exception to be thrown. PKCS#11 defines the meaning of an error-code, which may depend on the context in which the error occurs.

Version:

1.0

Author:

Karl Scheibelhofer

See Also:

Serialized Form

Field Summary

Fields inherited from class iaik.pkcs.pkcs11.TokenException

encapsulatedException

Constructor Summary

Constructors

Constructor and Description
PKCS11Exception(long errorCode) Constructor taking the error code as defined for the CKR_* constants in PKCS#11.
PKCS11Exception(sun.security.pkcs11.wrapper.PKCS11Exception ex)

Method Summary

Modifier and Type	Method and Description
long	getErrorCode() Returns the PKCS#11 error code.
String	getMessage() This method gets the corresponding text error message from a property file.

Methods inherited from class iaik.pkcs.pkcs11.TokenException

getEncapsulatedException, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PKCS11Exception

public PKCS11Exception(long errorCode)

Constructor taking the error code as defined for the CKR_* constants in PKCS#11.

Parameters:

errorCode - The PKCS#11 error code (return value).

PKCS11Exception

public PKCS11Exception(sun.security.pkcs11.wrapper.PKCS11Exception ex)

Method Detail

getMessage

public String getMessage()

This method gets the corresponding text error message from a property file. If this file is not available, it returns the error code as a hex-string.

Overrides:

getMessage in class Throwable

Returns:

The message or the error code; e.g. "CKR_DEVICE_ERROR" or "0x00000030".

getErrorCode

public long getErrorCode()

Returns the PKCS#11 error code.

Returns:

The error code; e.g. 0x00000030.