NAME

   CSSM_CSP_CreateDigestContext - Create a digest cryptographic
                                  context (CDSA)

 SYNOPSIS

   # include <cssm.h>

        CSSM_RETURN CSSMAPI CSSM_CSP_CreateDigestContext
        (CSSM_CSP_HANDLE CSPHandle,
        CSSM_ALGORITHMS AlgorithmID,
        CSSM_CC_HANDLE *NewContextHandle)

 LIBRARY

   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS

   CSPHandle (input)
           The handle that describes the add-in cryptographic service
           provider module used to perform this function. If a NULL handle
           is specified, CSSM returns error.

   AlgorithmID (input)
           The algorithm identification number for message digests.

   NewContextHandle (output)
           Cryptographic context handle.

 DESCRIPTION

   This function creates a digest cryptographic context, given a handle of
   a CSP and an algorithm identification number. The cryptographic context
   handle is returned. The cryptographic context handle can be used to call
   digest cryptographic 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.

 SEE ALSO

   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions: CSSM_DigestData
              CSSM_DigestDataInit
              CSSM_DigestDataUpdate
              CSSM_DigestDataFinal
              CSSM_GetContext
              CSSM_SetContext
              CSSM_DeleteContext
              CSSM_GetContextAttribute
              CSSM_UpdateContextAttributes