CSSM_CSP_CreateSignatureContextCSSM_CSP_CreateSignatureContext(3)

NAME    [Toc]    [Back]

       CSSM_CSP_CreateSignatureContext - Create a signature cryptographic
 context (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN    CSSMAPI     CSSM_CSP_CreateSignatureContext
       (CSSM_CSP_HANDLE  CSPHandle,  CSSM_ALGORITHMS AlgorithmID,
       const CSSM_ACCESS_CREDENTIALS *AccessCred, const  CSSM_KEY
       *Key, CSSM_CC_HANDLE *NewContextHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       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.  The algorithm
       identification number for a  signature/verification  algorithm.
   A  pointer  to the set of one or more credentials
       required to unlock the private key. The credentials structure
  can  contain  an immediate value for the credential,
       such as a passphrase, or the caller can specify a callback
       function  the  CSP  can  use to obtain one or more credentials.
 Credentials are required for signature  operations,
       not  for verify operations.  The key used to sign and verify.
 The caller passes a pointer to a  CSSM_KEY  structure
       containing the key and the key length.  Cryptographic context
 handle.

DESCRIPTION    [Toc]    [Back]

       This function creates a  signature  cryptographic  context
       for sign and verify, given a handle of a CSP, an algorithm
       identification number, a  key,  and  an  AccessCredentials
       structure. The AccessCredentials structure will be used to
       unlock the private key when this context is used  to  perform
 a signing operation. The cryptographic context handle
       is returned. The cryptographic context handle can be  used
       to call sign and verify cryptographic functions.

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.

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions:     CSSM_SignData(3),     CSSM_SignDataInit(3),
       CSSM_SignDataUpdate(3),  CSSM_SignDataFinal(3), CSSM_VerifyData(3),   CSSM_VerifyDataInit(3),    CSSM_VerifyDataUpdate(3),    CSSM_VerifyDataFinal(3),   CSSM_GetContext(3),
       CSSM_SetContext(3), CSSM_DeleteContext(3), CSSM_GetContextAttribute(3), CSSM_UpdateContextAttributes(3)



                               CSSM_CSP_CreateSignatureContext(3)