# License Information

Your license key controls whether you have the full version of the KeyView SDK, or a trial version. It also determines whether the following advanced features are enabled:

- Advanced character set detection with the character set detection library (`kvlangdetect`).

- Advanced document readers:

  - Microsoft Outlook Personal Folders (PST) readers (`pstsr`, `pstnsr`, and `pstxsr`)

  - Lotus Notes database (NSF) reader (`nsfsr`)

  - Mailbox (MBX) reader (`mbxsr`)

- Processing of documents protected by Microsoft RMS encryption.

- Optical Character Recognition (OCR) to attempt to filter text that might be visible in raster image files.

If you obtain a new license key from Micro Focus, you must update the licensing information that you pass to KeyView. See Pass License Information to KeyView.

## Enable Advanced Document Readers

To enable advanced readers, you must obtain an appropriate license key from Micro Focus and pass the license key to KeyView as described in Pass License Information to KeyView.

If you are enabling the MBX reader in an existing installation of Filter, in addition to updating the license key, change the parameter `208=eml` to `208=mbx` in the `formats.ini` file.

## Pass License Information to KeyView

To provide license information to KeyView, do one of the following:

- Provide the license information through the API. Micro Focus recommends using this approach.

- Provide the license information as a text file named `kv.lic`. In earlier versions of KeyView, license information had to be stored in a file and included in the `bin` folder with the KeyView libraries. The ability to provide license information as a file has been deprecated and might be removed in future. You should no longer include license information in your application as a file. Micro Focus recommends that you pass license information to KeyView through the API instead.

If you have an evaluation version of KeyView and purchase a full version of the SDK, or you are adding a document reader (for example, the PST reader), you must update the license information that you pass to KeyView.

To provide license information through the API

- In the C API, provide license information when you initialize KeyView by calling `fpInitWithLicenseData()`.
- In the C++ API, provide license information when you start a new session (see the constructor for the `Session` class).
- In the .NET API, provide license information to KeyView when you instantiate the `Filter` object.
- In the Java API, provide license information to KeyView when you instantiate the `Filter` object.

To provide license information as a file

1. Open or create the license key file, `kv.lic`, in a text editor. The file must be saved in the same directory as the KeyView libraries, and must contain your organization name and license key.

       COMPANY NAME
       XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX

2. Replace the text `COMPANY NAME` with the company name that appears at the top of the License Key Sheet provided by Micro Focus. Enter the text exactly as it appears in the document.
3. Replace the characters `XXXXXX-XXXXXXX-XXXXXXX-XXXXXXX` with the appropriate license key from the License Key Sheet provided by Micro Focus. The license key is listed in the Key column in the Standalone Products table. The key is a string that contains 31 characters, for example, `2TQD22D-2M6FV66-2KPF23S-2GEM5AB`. Enter the characters exactly as they appear in the document, including the dashes, but do not include a leading or trailing space.

4. The finished `kv.lic` file looks similar to the following:

       Autonomy
       24QD22D-2M6FV66-2KPF23S-2G8M59B

5. Save the file.

_FT_HTML5_bannerTitle.htm