NAME
CSSM_DigestDataClone, CSP_DigestDataClone — Clone a staged message digest (CDSA)
SYNOPSIS
# include <cssm.h>
API:
CSSM_RETURN CSSMAPI CSSM_DigestDataClone
(CSSM_CC_HANDLE CCHandle,
CSSM_CC_HANDLE *ClonednewCCHandle)
SPI:
CSSM_RETURN CSSMCSPI CSP_DigestDataClone
(CSSM_CSP_HANDLE CSPHandle,
CSSM_CC_HANDLE CCHandle,
CSSM_CC_HANDLE ClonednewCCHandle) |
LIBRARY
Common Security Services Manager library (cdsa$incssm300_shr.exe)
API PARAMETERS
| CCHandle (input) | | The handle that describes the context of a staged
message digest operation. |
| ClonednewCCHandle (output) |
| | | The cloned digest context handle. The handle will
be set to CSSM_INVALID_HANDLE if the function fails. |
SPI PARAMETERS
| CSPHandle (input) |
| | | The handle that describes the add-in Cryptographic
Service Provider module used to perform calls to CSSM for the memory
functions managed by CSSM. |
DESCRIPTION
This function clones a given staged message digest context
with its cryptographic attributes and intermediate result.
NOTES
When a digest context is cloned, a new context is created
with data associated with the parent context. Changes made to the
parent context after calling this function will not be reflected
in the cloned context. The cloned context could be used with the CSSM_DigestDataUpdate() and CSSM_DigestDataFinal() functions.
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.
None specific to this call.
SEE ALSO
Books
Intel CDSA Application Developer's Guide
Online Help
Functions for the CSSM API:
CSSM_DigestData, CSSM_DigestDataInit, CSSM_DigestDataUpdate, CSSM_DigestDataFinal
Functions for the CSP SPI:
CSP_DigestData, CSP_DigestDataInit, CSP_DigestDataUpdate, CSP_DigestDataFinal
