GFpGetElementOctString

Extracts an element of the finite field from the context to the output octet string.

Syntax

IppStatus ippsGFpGetElementOctString(const IppsGFpElement* pA, Ipp8u* pStr, int strSize, IppsGFpState* pGFp);

Include Files

ippcp.h

Parameters

pA	Pointer to the context of the finite field element.
pStr	Pointer to the octet string.
strSize	Size of the octet string buffer in bytes.
pGFp	Pointer to the context of the finite field.

Description

This function extracts the element of the finite field from the context to the octet string. If the string length is not enough to hold the whole finite field element, the function writes only a part of the element.

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 pGFp and pA context parameters does not match the operation.
ippStsSizeErr	Indicates an error if the length of the string is zero or negative.
ippStsOutOfRangeErr	Indicates an error condition if the element pA does not belong to the finite field specified by the context pGFp.