Validates key components of the RSA cryptographic system.
Syntax
IppStatus ippsRSAValidate(const IppsBigNumState* pE, int nTrials, Ipp32u* pResult, IppsRSAState* pCtx, IppBitSuppler rndFunc, void* pRndParam);
Parameters
pE |
Pointer to the IppsBigNumState context of the RSA public exponent. |
nTrails |
Security parameter specified for the Miller-Rabin probable primality. |
pResult |
Pointer to the result of validation. |
pCtx |
Pointer to the IppsRSAState context. |
rndFunc |
Pseudorandom number generator. |
pRndParam |
Pointer to the context of the pseudorandom number generator. |
Description
This function is declared in the ippcp.h file. The function validates key components of the RSA cryptographic system and stores the result (IS_VALID_KEY or IS_INVALID_KEY) of the validation procedure in *pResult.
Note
Because the RSAGenerate and RSAValidate functions use similar algorithms, RSAValidate is unnecessary if the RSA system is generated by RSAGenerate. Call RSAValidate when RSA keys are got from outside and you are not sure whether they are valid.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or warning. |
ippStsNullPtrErr |
Indicates an error condition if any of the specified pointers is NULL. |
ippStsContextMatchErr |
Indicates an error condition if the context parameter does not match the operation. |
ippStsBadArgErr |
Indicates an error condition if nBitsN > nBitsP or nTrials < 1. |
ippStsLengthErr |
Indicates an error condition if the length of the Big Number specified by pE is less than 1. |
ippStsOutOfRangeErr |
Indicates an error condition if the length of the Big Number specified by pE is too big to be stored in the IppsRSAState context. |