NAME

CSSM_VerifyMac

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_VerifyMac
    (CSSM_CC_HANDLE CCHandle,
    const CSSM_DATA_PTR DataBufs,
    uint32 DataBufCount,
    const CSSM_DATA_PTR Mac)

DESCRIPTION

This function verifies a message authentication code for the supplied data.

PARAMETERS

CCHandle (input)

The handle that describes the context of this cryptographic operation used to link to the CSP-managed information.

DataBufs (input)

A pointer to a vector of CSSM_DATA structures that contain the data to be operated on.

DataBufCount (input)

The number of DataBufs.

Mac (input)

A pointer to the CSSM_DATA structure containing the MAC to verify.

RETURN VALUE

A CSSM return value. This function returns CSSM_OK if successful, and returns an error code if an error has occurred.

ERRORS

CSSM__CSP_INVALID_CONTEXT_HANDLE

Invalid context handle.

CSSM__CSP_INVALID_CONTEXT

Context type and operation do not match.

CSSM__CSP_INVALID_DATA_POINTER

Invalid input or output CSSM_DATA pointer.

CSSM__CSP_INVALID_DATA_COUNT

Invalid input data count; data count cannot be 0.

CSSM__CSP_INVALID_DATA

Invalid input or output CSSM_DATA buffer.

CSSM__CSP_INVALID_ALGORITHM

Unknown algorithm.

CSSM__CSP_MEMORY_ERROR

Not enough memory to allocate.

CSSM__CSP_OPERATION_UNSUPPORTED

Verify MACs Service not supported.

CSSM__CSP_OPERATION_FAILED

Cryptographic operation failed.

CSSM__CSP_VECTOROFBUFS_UNSUPPORTED

Supports only a single buffer of input.

CSSM__CSP_INVALID_ATTR_KEY

Invalid or missing key attribute in the context.

CSSM__CSP_INVALID_KEY

Invalid or missing key data in the context attribute.

CSSM__CSP_INVALID_KEYCLASS

Key class is not session key class.

CSSM__CSP_KEY_ALGID_MISMATCH

The supplied key does not match the operation.

CSSM__CSP_KEY_KEYHEADER_INCONSISTENT

Key header and key data is inconsistent.

CSSM__CSP_KEY_FORMAT_INCORRECT

Unknown key format.

CSSM__CSP_INVALID_KEY_SIZE_IN_BITS

Key size in bits unsupported.

SEE ALSO

CSSM_VerifyMacInit, CSSM_VerifyMacUpdate,
CSSM_VerifyMacFinal