Contents

RSA_InitPublicKey, RSA_InitPrivateKeyType1, RSA_InitPrivateKeyType2

Initialize user-supplied memory as the IppsRSAPublicKeyState or IppsRSAPrivateKeyState context for future use.

Syntax

IppStatus ippsRSA_InitPublicKey(int rsaModulusBitSize, int publicExpBitSize, IppsRSAPublicKeyState* pKey, int keyCtxSize);

IppStatus ippsRSA_InitPrivateKeyType1(int rsaModulusBitSize, int privateExpBitSize, IppsRSAPrivateKeyState* pKey, int keyCtxSize);

IppStatus ippsRSA_InitPrivateKeyType2(int factorPBitSize, int FactorQBitSize, IppsRSAPrivateKeyState* pKey, int keyCtxSize);

Include Files

ippcp.h

Parameters

rsaModulusBitSize

Length of the RSA system in bits (that is, the length of the composite RSA modulus n in bits).

publicExpBitSize

Length of the RSA public exponent in bits (that is, the length of the e component of the RSA public key).

privateExpBitSize

Length of the RSA private exponent in bits (that is, the length of the d component of the type 1 RSA private key).

factorPBitSize, FactorQBitSize

Length in bits of the p and q factors of the RSA modulus n = p*q.

pKey

Pointer to the IppsRSAPublicKeyState or IppsRSAPrivateKeyState context being initialized. The context depends on the function.

keyCtxSize

Available size in bytes of the memory buffer being initialized.

Description

These functions initialize the memory pointed by pKey as the IppsRSAPublicKeyState or IppsRSAPrivateKeyState context, depending on the function. To determine the size of the memory buffer, call the appropriate RSA_GetSizePublicKey, RSA_GetSizePrivateKeyType1, RSA_GetSizePrivateKeyType2 function prior to calling any of these functions.

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.

ippStsNotSupportedModeErr

Indicates an error condition if rsaModulusBitSize < 32 or rsaModulusBitSize > 4096, factorPBitSize < 16 or factorPBitSize > 4096, or factorQBitSize < 16 or factorQBitSize > 4096.

ippStsBadArgErr

Indicates an error condition if publicExpBitSize > rsaModulusBitSize or privateExpBitSize > rsaModulusBitSize.

ippStsMemAllocErr

Indicates an error condition if the allocated memory is insufficient for the operation.

Related Information

previous

RSA_GetSizePublicKey, RSA_GetSizePrivateKeyType1, RSA_GetSizePrivateKeyType2

next

RSA_SetPublicKey, RSA_SetPrivateKeyType1, RSA_SetPrivateKeyType2