ULSaveEncryptionKey function

Saves the encryption key in Palm dynamic memory.

Syntax

ul_bool ULSaveEncryptionKey(
ul_char * key,
ul_u_long * creator,
ul_u_long * feature-num
);

Parameters

key A pointer to the encryption key.

creator A pointer to the creator ID of the feature that holds the encryption key. The default value is NULL.

feature-num A pointer to the feature number that holds the encryption key. If feature-num is NULL, the application uses the UltraLite default value of 100.

Returns

True if the operation is successful.
False if the operation failed. This occurs if the feature was not found or if the supplied buffer length is insufficient to hold the key plus a terminating null character.

Remarks

On the Palm OS the encryption key is saved in dynamic memory as a Palm feature. Features are indexed by creator and a feature number. They are not backed up and are cleared on any reset of the device.

Applies to Palm OS applications.