GFpECPVerifyDSA, GFpECPVerifyNR, GFpECPVerifySM2
GFpECPVerifyDSA
, GFpECPVerifyNR
, GFpECPVerifySM2
Verifies authenticity of the digital signature over a message digest (ECDSA).
Syntax
IppStatus ippsGFpECVerifyDSA(const IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
IppStatus ippsGFpECVerifyNR(onst IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
IppStatus ippsGFpECVerifySM2(const IppsBigNumState*
pMsgDigest
, const IppsGFpECPoint*
pRegPublic
, const IppsBigNumState*
pSignR
, const IppsBigNumState*
pSignS
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
Include Files
ippcp.h
Parameters
- pMsgDigest
- Pointer to the message digestmsg.
- pRegPublic
- Pointer to the signer's regular public key.
- pSignR
- Pointer to the integerrof the digital signature.
- pSignS
- Pointer to the integersof the digital signature.
- pResult
- Pointer to the digital signature verification result.
- pEC
- Pointer to the context of the elliptic curve.
- pScratchBuffer
- Pointer to the scratch buffer.
Description
These functions verify authenticity of the digital signature generated by the
ippsGFpECPSignDSA
, ippsGFpECPSignNR
, and ippsGFpECPSignSM2
functions, respectively. The signature consists of two large integers: r
and s
.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 any of the contexts pointed to bypMsgDigest,pRegPublic,pSignR,pSignS, orpECdoes not match the operation.
- ippStsMessageErr
- Indicates an error condition if the value ofmsgpointed to bypMsgDigestfalls outside the range of [1,n-1], wherenis the order of the elliptic curve base pointG.
- ippStsRangeErr
- Indicates an error condition if any of the parameters pointed to bypSignRorpSignSis negative.