NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN       CSSMAPI        CSSM_CSP_CreateMacContext
       (CSSM_CSP_HANDLE  CSPHandle,  CSSM_ALGORITHMS AlgorithmID,
       const CSSM_KEY *Key, CSSM_CC_HANDLE *NewContextHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       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.   The  algorithm
       identification number for the MAC algorithm.  The key used
       to generate a message authentication code. Caller passes a
       pointer to a CSSM_KEY structure containing the key.  Cryptographic
 context handle.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions:  CSSM_GenerateMac(3),  CSSM_GenerateMacInit(3),
       CSSM_GenerateMacUpdate(3),       CSSM_GenerateMacFinal(3),
       CSSM_VerifyMac(3),   CSSM_VerifyMacInit(3),   CSSM_VerifyMacUpdate(3),  CSSM_VerifyMacFinal(3), CSSM_GetContext(3),
       CSSM_SetContext(3), CSSM_DeleteContext(3), CSSM_GetContextAttribute(3), CSSM_UpdateContextAttributes(3)



                                     CSSM_CSP_CreateMacContext(3)