iaik.pkcs.pkcs11.objects

Interface Object.VendorDefinedObjectBuilder

Enclosing class:

Object

public static interface Object.VendorDefinedObjectBuilder

If an application uses vendor defined objects, it must implement this interface and install such an object handler using setVendorDefinedObjectBuilder.

Version:

1.0

Author:

Karl Scheibelhofer

Method Summary

Modifier and Type	Method and Description
Object	build(Session session, long objectHandle) This method should instantiate an Object of this class or of any sub-class.

Method Detail

build

Object build(Session session,
             long objectHandle)
      throws PKCS11Exception

This method should instantiate an Object of this class or of any sub-class. It can use the given handles and PKCS#11 module to retrieve attributes of the PKCS#11 object from the token.

Parameters:

session - The session to use for reading attributes. This session must have the appropriate rights; i.e. it must be a user-session, if it is a private object.

objectHandle - The object handle as given from the PKCS#111 module.

Returns:

The object representing the PKCS#11 object. The returned object can be casted to the according sub-class.

Throws:

PKCS11Exception - If getting the attributes failed.

Postconditions:

(result != null)

Preconditions:

(session != null)