fpConfigureRMS()

This function provides a way to set the credentials required to access Azure RMS protected files. After you set these credentials, the XML Export and File Extraction API functions can operate on the contents of the Azure RMS files.

Syntax

KVErrorCode pascal *fpConfigureRMS(
    void*             pContext,
    KVRMSCredentials* credentials);

Arguments

pContext A pointer returned from fpInit() and fpInitWithLicenseData().
credentials

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

Set this value to NULL to discard the existing credentials. You can call the function again with new credentials to override the existing configuration.

Before you fill out the KVRMSCredentials structure, use the macro KVStructInit to initialize the KVStructHead structure.

Returns

The return value is an error code. See KVErrorCode.

If the function returns KVERR_General, you can retrieve the extended error code by using the fpGetKvErrorCodeEx() function (see fpGetKvErrorCodeEx).

Discussion

CAUTION: When XML Export or File Extraction API functions access the protected contents of Azure RMS-protected files, KeyView may place decrypted contents into the temporary directory. If you want to manage the security of such files, you might want to change the temporary directory, by using KVXMLConfig().