Visible to Intel only — GUID: GUID-7F6741BC-3E5E-463E-9CA3-FD9CAE7151A8
Visible to Intel only — GUID: GUID-7F6741BC-3E5E-463E-9CA3-FD9CAE7151A8
DLPGetDP
Retrieves a particular domain parameter of the DL-based cryptosystem over GF(p).
Syntax
IppStatus ippsDLPGetDP(IppsBigNumState* pDP, IppDLPKeyTag tag, const IppsDLPState* pCtx);
Include Files
ippcp.h
Parameters
pDP |
Pointer to the output Big Number context. |
tag |
Tag specifying the domain parameter to be retrieved. |
pCtx |
Pointer to the cryptosystem context. |
Description
The function retrieves value of a particular domain parameter of the DL-based cryptosystem from the IppsDLPState context and stores the value in the Big Number context *pDP. The domain parameter to be retrieved is determined by tag as follows:
If tag == IppDLPkeyP, the function retrieves value of the characteristic p, the size of the prime finite field GF(p).
If tag == IppDLPkeyR, the function retrieves value of the characteristic r, the prime divisor of (p-1) and the order of g.
If tag == IppDLPkeyG, the function retrieves value of the characteristic g, the element of GF(p) generating a multiplicative subgroup of order r.
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. |
ippStsIncompleteContextErr |
Indicates an error condition if the cryptosystem context has not been properly set up. |
ippStsOutOfRangeErr |
Indicates an error condition if the Big Number specified by pDP is too small for the DL parameter. |
ippStsBadArgErr |
Indicates an error condition if the domain parameter specified by the tag does not match the IppsDLPState context. |