Copyright Digital Equipment Corp. All rights reserved.

CSSM_CSP_CreateDigestContext

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