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