DigestDataClone

NAME
  DigestDataClone,
  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.  See CDSA.

  None specific to this call.

SEE ALSO
  Books

  Intel CDSA Application Developer's Guide (see CDSA)

  Other Help Topics

  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