CSSM_CSP_CreateRandomGenContext(3)CSSM_CSP_CreateRandomGenContext(3)NAMECSSM_CSP_CreateRandomGenContext - Create a random number generation
cryptographic context (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI CSSM_CSP_CreateRandomGenContext (CSSM_CSP_HANDLE
CSPHandle, CSSM_ALGORITHMS AlgorithmID, const CSSM_CRYPTO_DATA *Seed,
uint32 Length, CSSM_CC_HANDLE *NewContextHandle)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in cryptographic service provider
module used to perform this function. If a NULL handle is specified,
CSSM returns AN error. The algorithm identification number for random
number generation. A seed used to generate THE random number. The
caller can either pass a seed and seed length in bytes or pass a call‐
back function. If NULL is passed, the cryptographic service provider
will use its default seed-handling mechanism. The length of the random
number to be generated. Cryptographic context handle.
DESCRIPTION
This function creates a random number generation cryptographic context,
given a handle of a CSP, an algorithm identification number, a seed,
and the length of the random number in bytes. The cryptographic context
handle is returned and can be used for the random number generation
function.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions: CSSM_GenerateRandom(3), CSSM_GetContext(3), CSSM_SetCon‐
text(3), CSSM_DeleteContext(3), CSSM_GetContextAttribute(3),
CSSM_UpdateContextAttributes(3)CSSM_CSP_CreateRandomGenContext(3)