KRSP_ProcessRecoveryFields
CSSM_RETURN CSSMKRSPI KRSP_ProcessRecoveryFields
(CSSM_KRSP_HANDLE KRSPHandle,
CSSM_CC_HANDLE KREnablementContextHandle,
const CSSM_CONTEXT_PTR KREnablementContext,
CSSM_CC_HANDLE CryptoContextHandle,
const CSSM_CONTEXT_PTR CryptoContext,
CSSM_DATA_PTR KRSPOptions,
uint32 KRFlags,
CSSM_DATA_PTR KRFields)
This call processed a set of key recovery fields given the key recovery context, and the cryptographic context for the encryption operation, and returns a non-NULL cryptographic context handle if the processing was successful. The returned handle may be used for the decrypt API calls of the CSSM.
- KRSPHandle (input)
The handle that describes the add-in key recovery service provider module used to perform up calls to CSSM for the memory functions managed by CSSM.
- KREnablementContextHandle (input)
The handle that describes the context of this key recovery operation used to link to the KRSP-managed information.
- KREnablementContext (input)
Pointer to CSSM_CONTEXT structure that describes the attributes with this key recovery context.
- CryptoContextHandle (input)
The handle that describes the cryptographic context used to link to the CSP-managed information.
- CryptoContext (input)
Pointer to CSSM_CONTEXT structure that describes the attributes of the cryptographic context.
- KRSPOptions (input)
The key recovery service provider specific options. These options are uninterpreted by the SKMF, but passed on to the KRSP.
- KRFlags (input)
Flag values for key recovery fields generation. Defined values are:
- KR_ENT-signifies that only the enterprise key recovery fields should be processed.
- KR_LE-signifies that only the law enforcement key recovery fields should be processed.
- KR_ALL-signifies that LE, and ENT key recovery fields should be processed.
- KR_OPTIMIZE-signifies that available optimization options are to be adopted.
- KRFields (input)
The key recovery fields to be processed in the form of a data blob.
A CSSM return value. This function returns CSSM_OK if the processing operation is successful and returns an error if an error has occurred.
- CSSM_KR_INVALID_CC_HANDLE
Invalid crypto context handle.
- CSSM_KR_INVALID_KRC_HANDLE
Invalid key recovery context handle.
- CSSM_KR_INVALID_OPTIONS
Invalid recovery options.
- CSSM_MEMORY_ERROR
Memory error.
Contents | Next section | Index |