Visible to Intel only — GUID: GUID-8C78E1E8-D1DA-4BA1-A4D2-F476D28E89E1
Visible to Intel only — GUID: GUID-8C78E1E8-D1DA-4BA1-A4D2-F476D28E89E1
GFpExp
Raises an element of the finite field to the specified power.
Syntax
IppStatus ippsGFpExp(const IppsGFpElement* pA, const IppsBigNumState* pE, IppsGFpElement* pR, IppsGFpState* pGFp, Ipp8u* pScratchBuffer);
Include Files
ippcp.h
Parameters
pA |
Pointer to the context of the element of the finite field representing the base of the exponentiation. |
pE |
Pointer to the Big Number context storing the exponent. |
pR |
Pointer to the context of the resulting element of the finite field. |
pGFp |
Pointer to the context of the finite field. |
pScratchBuffer |
Pointer to the scratch buffer of size produced by ippsGFpScratchBufferSize. |
Description
This function raises the element of the finite field to the given non-negative power. The following pseudocode represents this operation: R = AE. The finite field is specified by the context pGFp. You can get the size of the scratch buffer by calling the function ippsGFpScratchBufferSize with nExponents equal to at least 1.
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 any of the IppsGFpState, IppsBigNumState, and IppsGFpElement context parameters does not match the operation. |
ippStsOutOfRangeErr |
Indicates an error condition if pA or pR does not belong to the finite field specified by the context pGFp. |