Developer Reference

Contents

SMS4Init

Initializes user-supplied memory as
IppsSMS4Spec
context for future use.

Syntax

IppStatus ippsSMS4Init(const Ipp8u*
pKey
, int
keyLen
, IppsSMS4Spec*
pCtx
, int
ctxSize
);
Include Files
ippcp.h
Parameters
pKey
Pointer to the SMS4 key.
keyLen
Key byte stream length. Must equal 16.
pCtx
Pointer to the buffer being initialized as
IppsSMS4Spec
context.
ctxSize
Available size of the buffer being initialized.
Description
This function initializes the memory pointed by
pCtx
as
IppsSMS4Spec
. The key is used to provide all necessary key material for both encryption and decryption operations.
If the
pKey
pointer is
NULL
, the function initializes 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.
ippStsMemAllocErr
Indicates an error condition if the allocated memory is insufficient for the operation.
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