RSA Security 5 manual Int BKeyAgreePhase1

B_KeyAgreePhase1

B_KeyAgreePhase1

int B_KeyAgreePhase1 (
B_ALGORITHM_OBJ	algorithmObject,	/* algorithm object */
unsigned char	*output,	/* output data buffer */
unsigned int	*outputLen,	/* length of output data */
unsigned int	maxOutputLen,	/* size of output data buffer */
B_ALGORITHM_OBJ	randomAlgorithm,	/* random byte source */
A_SURRENDER_CTX *surrenderContext		/* surrender context */
);

Description

B_KeyAgreePhase1 uses algorithmObject to generate the initial value for the other party, writing it to output, which is a buffer supplied by the caller of at least maxOutputLen bytes, and setting outputLen to the number of bytes written to output. The algorithm object for supplying random numbers is randomAlgorithm. The surrender context for processing and canceling during lengthy operations is surrenderContext; if its value is (A_SURRENDER_CTX *)NULL_PTR, Crypto-C does not use it. See B_KeyAgreeInit.

Return value

Value	Description
0	Operation was successful.
non-zero	see Appendix A, ”Crypto-C Error Types”

3 2 6 R S A B S A F E C r y p t o - C L i b r a r y R e f e r e n c e M a n u a l