DLPSetDP
DLPSetDP
Sets up a particular domain parameter of the DL-based cryptosystem over GF(p).
Syntax
IppStatus ippsDLPSetDP(const IppsBigNumState*
pDP
, IppDLPKeyTag
tag
, IppsDLPState*
pCtx
);
Include Files
ippcp.h
Parameters
- pDP
- Pointer to the domain parameter value to be set.
- tag
- Tag specifying the desired domain parameter.
- pCtx
- Pointer to the cryptosystem context.
Description
The function assigns the value specified by
pDP
to a particular domain parameter of the DL-based cryptosystem. The domain parameter to be set up is determined by tag
as follows:- Iftag==IppDLPkeyP, the function assigns value to the characteristicp, the size of the prime finite field GF(p).
- Iftag==IppDLPkeyR, the function assigns value to the characteristicr, the prime divisor of (p-1) and the order ofg.
- Iftag==IppDLPkeyG, the function assigns value to the characteristicg,the element of GF(p) generating a multiplicative subgroup of orderr.
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 isNULL.
- ippStsContextMatchErr
- Indicates an error condition if the context parameter does not match the operation.
- ippStsRangeErr
- Indicates an error condition if the Big Number specified bypDPis too big to be stored in theIppsDLPStatecontext.
- ippStsBadArgErr
- Indicates an error condition if some of the function parameters are invalid:
- Big Number specified bypDPis negative
- Domain parameter specified bytagdoes not match theIppsDLPStatecontext.