CSSM_SignData

Purpose

This function signs data using the private key associated with the public key specified in the context.

Format

CSSM_RETURN CSSMAPI CSSM_SignData 
               (CSSM_CC_HANDLE CCHandle,
               const CSSM_DATA_PTR DataBufs,
               uint32 DataBufCount,
               CSSM_DATA_PTR Signature)

Parameters

Input

CCHandle: The handle that describes the context of this cryptographic operation used to link to the CSP-managed information.
DataBufs: A pointer to a vector of CSSM_DATA structures that contain the data to be operated on.
DataBufCount: The number of DataBufs to be signed.

Output

Signature: A pointer to the CSSM_DATA structure containing the signature.

Return Value

CSSM_OK if the function was successful. CSSM_FAIL if an error occurred. Use CSSM_GetError to determine the exact error.

Notes

The output can be obtained either by filling the caller-supplied buffer or using the application's memory allocation functions to allocate space, which the application must later free. If the output buffer pointer is NULL, an error code CSSM_CSP_INVALID_DATA_POINTER is returned.

Related Information

CSSM_VerifyData
CSSM_SignDataInit
CSSM_SignDataUpdate
CSSM_SignDataFinal