NAME

CSSM_CSP_CreateMacContext

SYNOPSIS

CSSM_CC_HANDLE CSSMAPI CSSM_CSP_CreateMacContext
    (CSSM_CSP_HANDLE CSPHandle,
    uint32 AlgorithmID,
    const CSSM_KEY_PTR Key)

DESCRIPTION

This function creates a message authentication code cryptographic context, given a handle of a CSP, algorithm identification number, key, and the length of the key in bits. The cryptographic context handle is returned. The cryptographic context handle can be used to call message authentication code functions.

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 in a pointer to a CSSM_KEY structure containing the key.

RETURN VALUE

Returns a cryptographic context handle. If the handle is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM__INVALID_CSP_HANDLE

Invalid crypto services provider handle.

CSSM__MEMORY_ERROR

Internal memory error.

SEE ALSO

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