configureRMS()

This function provides a way to set the credentials required to access RMS protected files. After you set these credentials, the decryptFile() function is able to produce an unencrypted version of the RMS file.

CAUTION: When Panopticon functions access the protected contents of RMS protected files, KeyView might place decrypted contents into the temporary directory. You can specify the temporary directory when you call init().

Syntax

KVPanopticonError configureRMS(
   KVPanopticonContext* const context,
   const KVRMSCredentials* const rmsCredentials
);

Arguments

context

A pointer to KVPanopticonContext, initialized by calling init().

rmsCredentials

A pointer to a KVRMSCredentials structure that contains the required credentials.

You can store only one set of credentials at a time. You can call the function again with new credentials to override the existing configuration.

Set this value to NULL to discard the existing credentials.

Before you fill out the KVRMSCredentials structure, initialize the KVStructHead structure by using the macro KVStructInit.

Returns

If the function was successful, it returns KVP_Success. Otherwise, it returns a KVPanopticonError value describing the problem.