NAME    [Toc]    [Back]

       VerifyMacFinal,  CSSM_VerifyMacFinal, CSP_VerifyMacFinal -
       Finalize the staged message authentication code (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_VerifyMacFinal (CSSM_CC_HANDLE
 CCHandle, const CSSM_DATA *Mac) SPI: CSSM_RETURN CSSMCSPI
   CSP_VerifyMacFinal   (CSSM_CSP_HANDLE    CSPHandle,
       CSSM_CC_HANDLE CCHandle, const CSSM_DATA *Mac)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The  handle  that  describes  the  context of this cryptographic
 operation used to link to the CSP-managed information.
  A pointer to the CSSM_DATA structure containing the
       MAC to verify.

SPI PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform calls to CSSM for the memory
 functions managed by CSSM.

DESCRIPTION    [Toc]    [Back]

       This function finalizes the staged message  authentication
       code verification function.

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.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).     CSSMERR_CSP_INPUT_LENGTH_ERROR     CSSMERR_CSP_VERIFY_FAILED
 CSSMERR_CSP_INVALID_SIGNATURE

COMMENTS FOR SPI    [Toc]    [Back]

       The  output  is  returned  to  the  caller as specified in
       Buffer Management for Cryptographic Services.

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_VerifyMac(3),   CSSM_VerifyMacInit(3),   CSSM_VerifyMacUpdate(3)

       Functions for the CSP SPI:

       CSP_VerifyMac(3),                    CSP_VerifyMacInit(3),
       CSP_VerifyMacUpdate(3)



                                                VerifyMacFinal(3)