Visible to Intel only — GUID: GUID-75A77FCD-0606-41B4-B1C3-D12BB284A26F
Visible to Intel only — GUID: GUID-75A77FCD-0606-41B4-B1C3-D12BB284A26F
AES_GCMInit
Initializes user-supplied memory as the IppsAES_GCMState context for future use.
Syntax
IppStatus ippsAES_GCMInit(const Ipp8u* pKey, int keyLen, IppsAES_GCMState* pState, int ctxSize);
Include Files
ippcp.h
Parameters
pKey |
Pointer to the secret key. |
keyLen |
Length of the secret key. |
pState |
Pointer to the buffer being initialized as IppsAES_GCMState context. |
ctxSize |
Available size of the buffer. |
Description
The function initializes the memory pointed by pState as the IppsAES_GCMState context. In addition, the function uses the initialization variable and additional authenticated data to provide all necessary key material for both encryption and decryption.
Call the AES_GCMGetSize function prior to AES_GCMInit to determine the size of the buffer.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or warning. |
ippStsNullPtrErr |
Indicates an error condition if the pState pointer is NULL. |
ippStsLengthErr |
Indicates an error condition if keyLen is not equal to 16, 24, or 32. |
ippStsMemAllocErr |
Indicates an error condition if the allocated memory is insufficient for the operation. |
Related Information