RSA Security 5 manual Int BEncryptFinal

B_EncryptInit B_EncryptInit

B_EncryptFinal

B_EncryptFinal

int B_EncryptFinal (
B_ALGORITHM_OBJ	algorithmObject,	/* algorithm object */
unsigned char	*partOut,	/* output data buffer */
unsigned int	*partOutLen,	/* length of output data */
unsigned int	maxPartOutLen,	/* size of output data buffer */
B_ALGORITHM_OBJ	randomAlgorithm,	/* random byte source */
A_SURRENDER_CTX *surrenderContext		/* surrender context */
);

Description

B_EncryptFinal finalizes the encrypting process specified by algorithmObject, writing any remaining encrypted output to partOut, which is a buffer supplied by the caller of at least maxPartOutLen bytes, and setting partOutLen to the number of bytes written to partOut. The algorithm object for supplying random numbers is randomAlgorithm; it may be (B_ALGORITHM_OBJ)NULL_PTR for encrypting algorithms that do not need random numbers. 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. algorithmObject is reset to the state it was in after the call to

, so that another encrypting process may be performed. See

.

Return value

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

3 1 2 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