NAME

   CSSM_CSP_CreateSignatureContext - Create a signature cryptographic
                                     context (CDSA)

 SYNOPSIS

   # include <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

   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 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 a
           signature/verification algorithm.

   AccessCred (input/optional)
           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.

   Key (input)
           The key used to sign and verify. The caller passes a pointer
           to a CSSM_KEY structure containing the key and the key length.

   NewContextHandle (output)
           Cryptographic context handle.

 DESCRIPTION

   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

   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

   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions: CSSM_SignData
              CSSM_SignDataInit
              CSSM_SignDataUpdate
              CSSM_SignDataFinal
              CSSM_VerifyData
              CSSM_VerifyDataInit
              CSSM_VerifyDataUpdate
              CSSM_VerifyDataFinal
              CSSM_GetContext
              CSSM_SetContext
              CSSM_DeleteContext
              CSSM_GetContextAttribute
              CSSM_UpdateContextAttributes