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.

If you obtain a new license key from OpenText, 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 OpenText 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 Viewing SDK, in addition to updating the license key, you must also follow these steps:

If you are using the registry file:

  1. Open the install.reg.txtin a text editor. The file is installed in the install\redist directory, where install is the directory in which you installed Viewing SDK.
  2. Under the key [HKEY_LOCAL_MACHINE\Software\Verity\Viewing SDK\KVMAILVE], change the parameter "233"="emlsr.dll" to "233"="mbxsr.dll".
  3. Save the file as install.reg and import the file into your Windows system registry.

If you are using the kvsdk.ini file:

  1. Open the kvsdk.ini file with a text editor. The file is installed in the root of the Windows directory.
  2. In the [KVMAILVE] section, change the parameter 233=emlsr.dll to 233=mbxsr.dll.

Pass License Information to KeyView

You must provide your license information to KeyView through the KeyView API.

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 using the Viewing API

  • After creating the VAPI window using CreateWindow() or CreateWindowEx(), send the VAPIMWP_INIT_SETLICENSE message, where YOUR_KEYVIEW_LICENSE is the license key provided by OpenText. For example:

    SendMessage(hWndVAPI, VAPIM_INIT, VAPIMWP_INIT_SETLICENSE, (LPARAM)"YOUR_KEYVIEW_LICENSE");

To provide license information using the ActiveX control

  • Set the License property of the control to the license key that was provided by OpenText. For example:

    AxKEYview1.License = "YOUR_KEYVIEW_LICENSE"