CSSM_CSP_CreateRandomGenContextCSSM_CSP_CreateRandomGenContext(3)

NAME    [Toc]    [Back]

       CSSM_CSP_CreateRandomGenContext  -  Create a random number
       generation cryptographic context (CDSA)

SYNOPSIS    [Toc]    [Back]

       # 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    [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 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
       callback  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    [Toc]    [Back]

       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    [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_GenerateRandom(3),   CSSM_GetContext(3),
       CSSM_SetContext(3), CSSM_DeleteContext(3), CSSM_GetContextAttribute(3), CSSM_UpdateContextAttributes(3)



                               CSSM_CSP_CreateRandomGenContext(3)