Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6ITokenImpl::findObjects ( ADD_OBJECT_TO_SESSION  pCallback,
CK_RV pRV,
CK_SESSION_HANDLE  hSession,
CK_OBJECT_HANDLE_PTR  phObject,
CK_ULONG  ulMaxObjectCount,
CK_ULONG_PTR  pulObjectCount 
)
pure virtual

Invoked when the PKCS 11 C_FindObjects() function is called.

The enclosing PKCS library holds maintains a session cache of all object handles available to be accessed by the calling application. This search function returns a list of object handles to the calling application. Each of those object handles must be passed to the pCallback function to be placed in the session cache and checked for allowed read access. Otherwise the calling application will not be able to use the object handles returned by this runction.

All other parameters are as defined by the PKCS 11 Version 2.40 specification (see reference 1). The function return code is meant to convey an error to the enclosing PKCS 11 library, while the pRV parameter returns specific PKCS 11 error codes to the calling application.

Parameters
pCallback[ in ] Notify the enclosing PKCS 11 library that the search has found an object to add to the current session.
pRV[ out ] PKCS 11 return value to be returned to the caller. CKR_FUNCTION_NOT_SUPPORTED is returned if the function is not implemented.
Returns
SuccessP6R::eOk 
FailureP6R::eNotInitializedA call to initialize() has not been made.
P6R::eInvalidState