CSSM_CSP_CreateMacContext

NAME

  CSSM_CSP_CreateMacContext - Create a message authentication code
                              cryptographic context (CDSA)

SYNOPSIS

  # include <cssm.h>

       CSSM_RETURN CSSMAPI CSSM_CSP_CreateMacContext
       (CSSM_CSP_HANDLE CSPHandle,
       CSSM_ALGORITHMS AlgorithmID,
       const CSSM_KEY *Key,
       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 the MAC algorithm.

  Key (input)
          The key used to generate a message authentication code. Caller
          passes a pointer to a CSSM_KEY structure containing the key.

  NewContextHandle (output)
          Cryptographic context handle.

DESCRIPTION

  This function creates a message authentication code cryptographic
  context, given a handle of a CSP, algorithm identification number,
  and a key.  The cryptographic context handle is returned.  The
  cryptographic context handle can be used to call message
  authentication code 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_GenerateMac
             CSSM_GenerateMacInit
             CSSM_GenerateMacUpdate
             CSSM_GenerateMacFinal
             CSSM_VerifyMac
             CSSM_VerifyMacInit
             CSSM_VerifyMacUpdate
             CSSM_VerifyMacFinal
             CSSM_GetContext
             CSSM_SetContext
             CSSM_DeleteContext
             CSSM_GetContextAttribute
             CSSM_UpdateContextAttributes