GFpSetElementOctString
GFpSetElementOctString
Assigns a value from the input octet string to an element of the finite field.
Syntax
IppStatus ippsGFpSetElementOctString(const Ipp8u*
pStr
, int
strSize
, IppsGFpElement*
pR
, IppsGFpState*
pGFp
);
Include Files
ippcp.h
Parameters
- pStr
- Pointer to the octet string.
- strSize
- Size of the octet string buffer in bytes.
- pR
- Pointer to the context of the finite field element.
- pGFp
- Pointer to the context of the finite field.
Description
This function assigns a value from the input octet string to an element of the finite field.
Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or warning.
- ippStsNullPtrErr
- Indicates an error condition in any of the following cases:
- EitherpRorpGFpisNULL.
- The length of the string is greater than zero and the pointerpStrisNULL.
- ippStsContextMatchErr
- Indicates an error condition if any of thepGFpandpRcontext parameters does not match the operation.
- ippStsSizeErr
- Indicates an error condition in any of the following cases:
- strSizeexceeds the length of an element of the finite field.
- strSize≤ 0.
- The maximum length of the element stored in the contextpRexceeds the maximum length of an element of the finite field specified by the contextpGFp.
- ippStsOutOfRangeErr
- Indicates an error condition in any of the following cases:
- The length of the element stored in the contextpRis not equal to the length of an element of the finite field specified by the contextpGFp.
- The value defined bypStrexceeds the modulusqof the basic prime finite field.