NAME

CSSM_KRPolicyInfo

SYNOPSIS

CSSM_RETURN CSSM_KRPolicyInfo
    (CSSM_CC_HANDLE CCHandle,
    CSSM_BOOL *LE_KRFlag,
    CSSM_BOOL *ENT_KRFlag,
    uint32 *LE_WorkFactor)

DESCRIPTION

This call returns the key recovery policy information for a given cryptographic context. The information returned constitutes the key recovery extension fields of a cryptographic context.

PARAMETERS

CCHandle (input)

The handle to the cryptographic context that is to be used.

LE_KRFlag (output)

The usability flag for law enforcement key recovery. Possible values are:

• TRUE-signifies that law enforcement key recovery enablement needs to be done

• FALSE-signifies that law enforcement key recovery enablement is either not required or has already been done.

ENT_KRFlag (output)

The usability flag for enterprise key recovery. Possible values are:

• TRUE-signifies that enterprise key recovery enablement needs to be done

• FALSE-signifies that enterprise key recovery enablement is either not required or has already been done.

LE_WorkFactor (output)

The workfactor value to use for law enforcement key recovery.

RETURN VALUES

A CSSM return value. This function returns CSSM_OK if successful and returns an error code if an error has occurred.

ERRORS

CSSM_KR_INVALID_CC_HANDLE

Invalid crypto context handle.

CSSM_MEMORY_ERROR

Memory error.