DLPValidateKeyPair

Validates private and public keys of the DL-based cryptosystem over GF(p).

Syntax

IppStatus ippsDLPValidateKeyPair(const IppsBigNumState* pPrivate, const IppsBigNumState* pPublic, IppDLPResult* pResult, IppsDLPState* pCtx);

Parameters

pPrivate	Pointer to the input private key privKey.
pPublic	Pointer to the output public key pubKey.
pResult	Pointer to the validation result.
pCtx	Pointer to the cryptosystem context.

Description

This function is declared in the ippcp.h file. The function validates the private key privKey and the public key pubKey of the DL-based cryptosystem. The result of the validation is stored in the *pResult and may be assigned to one of the enumerators listed below:

ippDLValid	Validation has passed successfully.
ippDLInvalidPrivateKey	(1 < `private` < (`R` - 1)) is false.
ippDLInvalidPublicKey	(1 < `public` ≤ (`P` - 1)) is false.
ippDLInvalidKeyPair	`public` != `G`^`private` (mod `P`).

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.