RSA Security 5 manual KIItem, Pointer to an Item structure see above

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:

avariable-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:

typedef struct { unsigned char *data; unsigned int len;

}ITEM;

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.

C h a p t e r 3 K e y I n f o Ty p e s 273