AI_RC2_CBCPadPEM
186 RSA BSAFE Crypto-C Library Reference Manual
AI_RC2_CBCPadPEM
Purpose:
This AI is similar to AI_RC2_CBCPad except that it uses the Privacy Enhanced Mail
(PEM) format. This AI allows you to parse and create PEM algorithm identifiers such
as used in PEM protocol. You call
B_SetAlgorithmInfo to initialize an algorithm
object from the encoded algorithm identifier, which includes PEM encoding of the
A_RC2_CBC_PARAMS structure defined in the description of AI_RC2_CBCPad. You call
B_GetAlgorithmInfo with this AI to create an encoded algorithm identifier from an
algorithm object that was created using
AI_RC2_CBCPad, AI_RC2_CBCPadBER, or
AI_RC2_CBCPadPEM.
Type of information this allows you to use:
an RFC 1423-style identifier that specifies the RC2-CBC With Padding encryption
algorithm. This algorithm info type is intended to process the value of a DEK-Info
field in a PEM-encapsulated header.
Format of info supplied to B_SetAlgorithmInfo:
pointer to a null-terminated string (char *) that gives the RC2-CBC identifier and
parameters. For example,
“RC2-CBC,BAgRIjNEVWZ3iA==”. Space and tab characters are
removed from the string before it is copied to the algorithm object.
B_SetAlgorithmInfo returns BE_WRONG_ALGORITHM_INFO if the algorithm identifier
specifies an identifier other than RC2-CBC.
Format of info returned by B_GetAlgorithmInfo:
pointer to a null-terminated string that gives the RC2-CBC identifier and parameters.
Crypto-C procedures to use with algorithm object:
B_EncryptInit, B_EncryptUpdate, B_EncryptFinal, B_DecryptInit,
B_DecryptUpdate, and B_DecryptFinal. You may pass (B_ALGORITHM_OBJ)NULL_PTR
for all
randomAlgorithm
arguments.
Algorithm methods to include in application’s algorithm chooser:
AM_RC2_CBC_ENCRYPT for encryption and AM_RC2_CBC_DECRYPT for decryption.
