Chapter 3 Key Info Types 273
KI_Item
KI_Item
Purpose:
This KI allows you to specify a generic keying material of any length. It may be used
to hold a secret key of a symmetric encryption algorithm, a key of a keyed hash
algorithm, a password object, etc.
Type of information this allows you to use:
a variable-length block of data (such as an RC4 key), a password for password-based
encryption algorithms, or the value of a secret key when it is recovered from a public-
key encryption block.
Format of info supplied to B_SetKeyInfo:
pointer to an ITEM structure:
where
data
is the address of the unsigned byte array and
len
is its length.
Format of info returned by B_GetKeyInfo:
pointer to an ITEM structure (see above)
Can get this info type if key object already has:
KI_Item, KI_8Byte, KI_24Byte, KI_DES8, KI_DES8Strong, or KI_DESX.
typedef struct {
unsigned char *data;
unsigned int len;
} ITEM;
