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
Success | P6R::eOk | |
Failure | P6R::eNotInitialized | A call to initialize() has not been made. |
P6R::eInvalidState | |