DecryptDataInitP(3) — Subroutines
NAME
DecryptDataInitP − Intialize the staged decrypt function with privilege (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI CSSM_DecryptDataInitP
(CSSM_CC_HANDLE CCHandle,
CSSM_PRIVILEGE Privilege)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
Privilege (input)
The privilege to be applied during the cryptographic operation.
See CSSM_DecryptDataInit() for other parameters.
DESCRIPTION
This function is similar to CSSM_DecryptDataInit(). It also accepts a USEE tag as a privilege request parameter. CSSM checks that either its own privilege set or the application’s privilege set (if the application is signed) includes the tag. If the tag is found and the service provider privilege set indicates that it is supported, the tag is forwarded to the service provider.
For staged operations using privilege initialization functions CSSM_DecryptDataInitP(), the completion functions CSSM_DecryptDataUpdate() and CSSM_DecryptDataFinalize() are used.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See CDSA_intro(3).
None specific to this call.
SEE ALSO
Books
Intel CDSA Application Developer’s Guide (see CDSA_intro(3))
Reference Pages
Functions: CSSM_DecryptData(3), CSSM_EncryptDataInit(3), CSSM_EncryptDataUpdate(3), CSSM_EncryptDataFinal(3), CSSM_EncryptDataP(3), CSSM_EncryptDataInitP(3), CSSM_DecryptP(3), CSSM_DecryptDataInitP(3), CSSM_QuerySize(3)