Symptoms
- The add-in is listed in the respective Microsoft Office program under File - Options - Add-ins under “Inactive application add-ins”
- There are registry keys for the add-in in HKEY_LOCAL_MACHINE
- Log files %appdata%\HvS-Consulting are available
Potential causes
- The user has deactivated the add-in
- An attempt was made to start the add-in, but an error occurred somewhere
Troubleshooting
In Outlook, go to File - Options - Add-Ins - go to “COM Addins” and activate IS-FOX Encrypt manually. Close the dialog. An attempt will now be made to load the add-in.
IS-FOX Encrypt is now loaded
Technically, the add-in can obviously be loaded, but it is prevented from being loaded when Outlook is started. The IS-FOX Encrypt log files are available, but do not contain an error message.
Please check the registry keys. It is very likely that the add-in is set to LoadBehavior 3 (= always start) in HKEY_LOCAL_MACHINE and another entry exists in HKEY_CURRENT_USER with LoadBehavior 0 (= never start). Change the entry in HKEY_CURRENT_USER to LoadBehavior = 3 and restart Outlook.
For installations on a terminal server, there is also the option of having an “AllowedUser.txt”. You can use the AllowedUsers.txt file to activate IS-FOX Encrypt on a terminal server for specific users only. A separate line is used for each e-mail address. When the add-in is started, this file is checked and compared with the local e-mail address.
- If the e-mail address is found in the allowedUser.txt, the add-in is loaded
- If the e-mail address is not found, the add-in is unloaded
In order for the information in this file to be retrieved, it must be located in the installation directory, i.e. usually in C:\Program Files(x86)\HvS-Consulting\IS-FOX Encrypt.
IS-FOX Encrypt is still not loaded
The add-in obviously cannot be loaded for technical reasons. Go back to File - Options - Add-Ins - go to “COM Addins” and select IS-FOX Encrypt again. If you now read “A runtime error occurred” under Loading behavior, we have an error with an incorrect or missing base component (.NET, VSTO, PIA).
In this case, you must first temporarily switch on the VSTO error messages in order to receive an exact error message and to narrow down the error.
- Close Microsoft Outlook
- Open “System and Security” in the Control Panel and then “System”
- Select “Advanced system settings” (requires admin rights)
- Select “Environment variables” at the bottom right
- Click on “New” under “System variables” and create a new variable:
- Name: VSTO_SUPPRESSDISPLAYALERTS
- Value: 0
- Confirm the dialog boxes with OK
- Restart Outlook
Now go back to File - Options - Add-Ins - go to “COM Addins” and activate IS-FOX Encrypt again. You should now receive a complete error message.
The 'common language runtime' could not be loaded (The 'common language runtime' could not be loaded):
The .NET Framework 4.5.2 or higher is not installed. Please install .NET Framework 4.5.2 or higher.
Access denied (exception of HRESULT: 0x80070005 (E_ACCESSDENIED):
The ClickOnce cache from Microsoft is faulty. Please reinstall the .NET framework.
- Open “Control Panel” - “Programs” - “Programs and Features”
- Select “Enable or disable Windows features” (requires admin rights)
- Deactivate both .NET frameworks (3.x and 4.x). Confirm with OK to uninstall the .NET frameworks
- Restart the computer
- Now install the .NET framework 4.5.2 or higher
- Restart the computer
- Start Outlook and test the IS-FOX Add-In
Exception when reading the manifest from “file:///C......./IS-FOX%20Encrypt.vsto”. The manifest may be invalid or the file could not be opened.
Possible cause 1: .NET Framework 4.5 or 4.5.1 is installed. Please install .NET Framework 4.5.2 or higher
Possible cause 2: The VSTO is not up to date. Please install the latest .NET programming support from Microsoft Office (Control Panel - Programs and Features - Microsoft Office - Change - Add or Remove Features)
After successful troubleshooting, please remove the system variable VSTO_SUPPRESSDISPLAYALERTS again.