skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: EncryptDataFinalEncryptDataFinal
go to next page: EncryptDataInitPEncryptDataInitP
end of book navigation links


EncryptDataInit
Library
Spi Parameters
Return Value
See Also
 Api Parameters
Description
Errors

NAME

EncryptDataInit: CSSM_EncryptDataInit, CSP_EncryptDataInit - Initialize the staged encrypt funciton (CDSA)

SYNOPSIS  

# include <cssm.h>

API:CSSM_RETURN CSSMAPI CSSM_EncryptDataInit(CSSM_CC_HANDLE CCHandle)SPI:CSSM_RETURN CSSMCSPI CSP_EncryptDataInit(CSSM_CSP_HANDLE CSPHandle,CSSM_CC_HANDLE CCHandle,const CSSM_CONTEXT *Context,CSSM_PRIVILEGE Privilege)


return to top LIBRARY  

Common Security Services Manager library (cdsa$incssm300_shr.exe)


return to top API PARAMETERS  

CCHandle (input)
 The handle that describes the context of this cryptographicoperation used to link to the CSP-managed information.


return to top SPI PARAMETERS  

CSPHandle (input)
 The handle that describes the add-in CryptographicService Provider module used to perform calls to CSSM for the memoryfunctions managed by CSSM.
Context (input)
 Pointer to CSSM_CONTEXT structure that describesthe attributes with this context.
Privilege (input)
 The export privilege to be applied during the cryptographicoperation. This parameter is forwarded to the CSP after CSSM verifiesthe caller and service provider privilege set includes the specifiedPRIVILEGE.


return to top DESCRIPTION  

This function initializes the staged encrypt function. Theremay be algorithm-specific and token-specific rules restricting thelengths of data following data update calls making use of theseparameters.

The CSP can require that the cryptographic context includeaccess credentials for authentication and authorization checks whenusing a private key or a secret key.


return to top RETURN VALUE  

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.


return to top ERRORS  

Errors are described in the CDSA Technical Standard.

None specific to this call.


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide

Online Help

Functions for the CSSM API:

CSSM_QuerySize, CSSM_DecryptData, CSSM_EncryptDataInit, CSSM_EncryptDataUpdate, CSSM_EncryptDataFinal, CSSM_EncryptDataP, CSSM_EncryptDataInitP, CSSM_DecryptP, CSSM_DecryptDataInitP

Functions for the CSP SPI:

CSP_QuerySize, CSP_DecryptData, CSP_EncryptDataInit, CSP_EncryptDataUpdate, CSP_EncryptDataFinal


go to previous page: EncryptDataFinalEncryptDataFinal
go to next page: EncryptDataInitPEncryptDataInitP