Specific registry functions

All registry options (required and optional) for the FileCap Outlook Plugin are described in this chapter.

HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE

All registry values described in this chapter can be deployed in HKEY_CURRENT_USER and/or HKEY_LOCAL_MACHINE.

  • The settings deployed in HKEY_LOCAL_MACHINE will be used by every user logged in to the system.
  • The settings deployed in HKEY_CURRENT_USER will only be used by that specific user the HKEY_CURRENT_USER overwrites the HKEY_LOCAL_MACHINE values.

For example; The language for the FileCap Outlook plugin is set in HKEY_LOCAL_MACHINE to English, then everybody on that system is getting the English version of the Outlook plugin, but one employee wants to have the plugin in the Dutch language. Then you can set the language value in HKEY_CURRENT_USER for this specific user to Dutch. The result will be that one employee is having the Dutch Outlook Plugin and the other employees see the English Outlook Plugin.

Default registry locations

By default after installation the registry key’s will be written in HKEY_LOCAL_MACHINE\SOFTWARE\FileCap or HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\FileCap depending on the version (32/64bits) installed.

For HKEY_CURRENT_USER the default location for registry key’s will be:
HKEY_CURRENT_USER\Software\FileCap or HKEY_CURRENT_USER\Software\WOW6432Node\FileCap

Required registry values per installation

API Key settings

To communicate with the FileCap server the Outlook Plugin needs to have the API key settings, these are required. By default the installation of the will put the registry keys containing the API settings in HKEY_LOCAL_MACHINE.

Name Type Value
APIKey REG_SZ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Server REG_SZ filecap.company.com

If you want to use HKEY_CURRENT_USER instead, you can download the .reg file with the following link:

Note when downloading above .reg file: You still need to edit the downloaded .reg file in a text editor like notepad. And replace the following:

Enter-FileCap-API-Key-Here” by the API key which can be found at “Plugin settings -> API Key” this is a unique key per FileCap server.

Enter-FileCap-FQDN-Here” by the FQDN of the FileCap server (For example: filecap.company.com)

Optional registry values

The following registry values are optional settings for the FileCap Outlook Plugin.

Language setting

This is an optional registry setting which defines the language used for the FileCap Outlook Plugin. When this option is not set the System language will be used. If the system language is not supported the FileCap Outlook Plugin will fallback to English.

Currently the FileCap Outlook Plugin is available in the following languages:

Language Type Value
Dutch REG_SZ nl
English REG_SZ en
Finnish REG_SZ fi
French REG_SZ fr
German REG_SZ de
Italian REG_SZ it
Spanish REG_SZ es
Swedish REG_SZ sv

The values above can be manually set in the registry, or set during installation.

Note: This option is available in FileCap Outlook Plugin version 4.1.0 and newer, please be aware that not all languages are supported if you use plugin version older then 4.2.0.

Allow failed connection

When this registry setting is used it will allow the user to send files also when the FileCap server is unavailable. Please be aware that this can cause data leaks.

Name Type Value Description
AllowFailedConnection REG_SZ false Sending emails is not possible when the FileCap server is unavailable.

Note: This is the default value which will be used when this registry setting is not set.

AllowFailedConnection REG_SZ true Sending emails is possible also when the FileCap server is unavailable.

Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.

Use FileCap for attachments

When this registry setting is used the checkbox “Send with FileCap” is checked by default, but the user can still manually disable it.

Name Type Value Description
SetDefaultUseFileCapForAttachments REG_SZ false The checkbox is not checked.

Note: This is the default value which will be used when this registry setting is not set.

SetDefaultUseFileCapForAttachments REG_SZ true The checkbox will be checked.

Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.

Force use FileCap for attachments

When this registry setting is used the checkbox “Send with FileCap” is checked by default, and cannot be disabled by the user.

Name Type Value Description
ForceUseFileCapForAttachments REG_SZ false The checkbox is not checked.

Note: This is the default value which will be used when this registry setting is not set.

ForceUseFileCapForAttachments REG_SZ true The checkbox will be checked and cannot be disabled.

Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.

Force use FileCap for messages and attachments

When this registry setting is used the email encryption is used by default.

Name Type Value Description
ForceUseFileCapForMessageAndAttachments REG_SZ false The mail encryption is not forced.

Note: This is the default value which will be used when this registry setting is not set.

ForceUseFileCapForMessageAndAttachments REG_SZ true The mail encryption will be used.

Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.

Startup Connection retry

When this registry setting is used the FileCap Outlook Plugin will retry a number of times when there is no connection possible to the FileCap server.

 

Name Type Value Description
StartupConnectionRetryCount REG_SZ 3 When there is no connection to the FileCap server the plugin will try again this number of times, before giving an error.

There will be an interval of 2 seconds before the next retry.

Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.

The above settings can also be downloaded as a registry file, which can be found here:
FileCap_Outlook_Per_User_Settings.reg