Developer Reference

Contents

SMS4SetKey

Resets the SMS4 secret key in the initialized
IppsSMS4Spec
context.

Syntax

IppStatus ippsSMS4SetKey(const Ipp8u*
pKey
, int
keyLen
, IppsSMS4Spec*
pCtx
);
Include Files
ippcp.h
Parameters
pKey
Pointer to the SMS4 key.
keyLen
Length of the secret key.
pCtx
Pointer to the initialized
IppsSMS4Spec
context.
Description
This function resets the SMS4 secret key in the initialized
IppsSMS4Spec
context with the user-supplied secret key.
If the
pKey
pointer is
NULL
, the function resets the context with the zero key, which can help you to clean up the actual secret before releasing the context.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if the
pCtx
pointer is
NULL
.
ippStsLengthErr
Returns an error condition if
keyLen
is not equal to 16.
ippStsContextMatchErr
Indicates an error condition if the context parameter does not match the operation.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804