# 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.

_FT_HTML5_bannerTitle.htm