CSSM_CSP_CreateSignatureContext

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

API Functions

CSSM_CSP_CreateRandomGenContext

CSSM_CSP_CreateSymmetricContext

CSSM_CSP_CreateSignatureContext

Library
Description
See Also

Parameters
Return Value

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 CryptographicService Provider module used to perform this function. If a NULLhandle is specified, CSSM returns error.
`AlgorithmID` (input)
		The algorithm identification number for a signature/verificationalgorithm.
`AccessCred` (input/optional)
		A pointer to the set of one or more credentialsrequired to unlock the private key. The credentials structure cancontain an immediate value for the credential, such as a passphrase,or the caller can specify a callback function the CSP can use toobtain one or more credentials. Credentials are required for signatureoperations, not for verify operations.
`Key` (input)		The key used to sign and verify. The caller passesa pointer to a CSSM_KEY structure containing the key and the keylength.
`NewContextHandle` (output)
		Cryptographic context handle.

DESCRIPTION

This function creates a signature cryptographic context forsign and verify, given a handle of a CSP, an algorithm identificationnumber, a key, and an AccessCredentials structure.The AccessCredentials structure will be usedto unlock the private key when this context is used to perform asigning operation. The cryptographic context handle is returned.The cryptographic context handle can be used to call sign and verify cryptographicfunctions.

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.