NAME

CSP_VerifyData

SYNOPSIS

CSSM_BOOL CSSMSPI CSP_VerifyData
    (CSSM_CSP_HANDLE CSPHandle,
    CSSM_CC_HANDLE CCHandle,
    const CSSM_CONTEXT_PTR Context,
    const CSSM_DATA_PTR DataBufs,
    uint32 DataBufCount,
    const CSSM_DATA_PTR Signature)

DESCRIPTION

This function verifies the input data against the provided signature.

PARAMETERS

CSPHandle (input)

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

CCHandle (input)

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

Context (input)

Pointer to CSSM_CONTEXT structure that describes the attributes with this context.

DataBufs (input)

A pointer to one or more CSSM_DATA structures containing the data be verified.

DataBufCount (input)

The number of DataBufs to be verified.

Signature (input)

A pointer to a CSSM_DATA structure which contains the signature and the size of the signature.

RETURN VALUE

A CSSM_TRUE return value signifies the signature was successfully verified. When CSSM_FALSE is returned, either the signature was not successfully verified or an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CSP_INVALID_CSP_HANDLE

Invalid CSP handle.

CSSM_CSP_INVALID_CONTEXT_HANDLE

Invalid context handle.

CSSM_CSP_INVALID_CONTEXT_POINTER

Invalid CSSM_CONTEXT pointer.

CSSM_CSP_INVALID_CONTEXT

Context type and operation do not match.

CSSM_CSP_INVALID_DATA_POINTER

Invalid input CSSM_DATA pointer.

CSSM_CSP_INVALID_DATA_COUNT

Invalid input data count; data count cannot be 0.

CSSM_CSP_INVALID_DATA

Invalid input CSSM_DATA buffer.

CSSM_CSP_INVALID_ALGORITHM

Unknown algorithm.

CSSM_CSP_OPERATION_UNSUPPORTED

Verify service not supported.

CSSM_CSP_OPERATION_FAILED

Cryptographic operation failed.

CSSM_CSP_INVALID_SIGNATURE

Invalid or missing signature.

CSSM_CSP_MEMORY_ERROR

Not enough memory to allocate.

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 public key class.

CSSM_CSP_KEY_USAGE_INCORRECT

Key usage does not allow verify.

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

CSP_SignData, CSP_VerifyDataInit, CSP_VerifyDataUpdate,
CSP_VerifyDataFinal