Wiki

Case Status
Log In

Wiki

 
How to disable the Brochet Add…
  • RSS Feed

Last modified on 6/10/2025 3:22 PM by User.

Tags:

How to disable the Brochet Add-Ins

The basic information and load behaviour of Word VSTO add-ins is controlled by a few registry values located in Root\Software\Microsoft\Office\Office application name\Addins\.

The Root is either HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE.

There is a key in this location for every available Word VSTO add-in.

Load Behaviour

Typically, the Load Behavior entry is intended to be set to 0, 3, or 16 (in decimal) when the VSTO Add-in is installed on end-user computers. By default, the Brochet installer sets the LoadBehavior entry of your Brochet VSTO add-in to 3.

Possible Load Behaviour values are:

Value (in
decimal)
VSTO
Add-in
status
VSTO Addin
load
behavior
Description
0 Unloaded Don't load automatically The application never tries to load the VSTO Add-in automatically. The user can try to manually load the VSTO Addin, or the VSTO Add-in can be loaded programmatically.
If the VSTO Add-in is successfully loaded, the LoadBehavior value remains 0, but the status of the VSTO Add-in in the COM Add-ins dialog box is updated to indicate that the
VSTO Add-in is loaded.
1 Loaded Don't load automatically The application never tries to load the VSTO Add-in automatically. The user can try to manually load the VSTO Addin, or the VSTO Add-in can be loaded programmatically.
Although the COM Add-ins dialog box indicates that the VSTO Add-in is loaded after the application starts, the VSTO Add-in isn't loaded until it's loaded manually or 
programmatically. If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 0,and remains at 0 after the application closes.
2 Unloaded Load at startup The application doesn't try to load the VSTO Add-in automatically. The user can try to manually load the VSTO Addin, or the VSTO Add-in can be loaded programmatically.
If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 3, and remains at 3 after the application closes.
3 Loaded Load at
startup
The application tries to load the VSTO Add-in when the application starts. This is the default value when you build or publish a VSTO Add-in in Visual Studio. If the
application successfully loads the VSTO Add-in, the LoadBehavior value remains 3. If an error occurs when loading the VSTO Add-in, the LoadBehavior value
changes to 2, and remains at 2 after the application closes.
8 Unloaded Load on demand The application doesn't try to load the VSTO Add-in automatically. The user can try to manually load the VSTO Addin, or the VSTO Add-in can be loaded programmatically.
If the application successfully loads the VSTO Add-in, the LoadBehavior value changes to 9.
9 Loaded Load on demand The VSTO Add-in will be loaded only when the application requires it. Such as when a user selects a UI element that uses functionality in the VSTO Add-in (for example,
a custom button in the Ribbon). If the application successfully loads the VSTO Add-in, the LoadBehavior value remains 9, but the status of the VSTO Add-in in the
COM Add-ins dialog box is updated to indicate that the VSTO Add-in is currently loaded. If an error occurs when loading the VSTO Add-in, the LoadBehavior value
changes to 8.
16 Loaded Load first time, then
load on demand
Set this value if you want your VSTO Add-in to be loaded on demand. The application loads the VSTO Add-in when the user runs the application for the first time.
The next time the user runs the application, the application loads any UI elements that are defined by the VSTO Add-in. However, the VSTO Add-in isn't loaded
until the user selects a UI element that is associated with the VSTO Add-in. When the application successfully loads the VSTO Add-in for the first time, the
LoadBehavior value remains 16 while the VSTO Add-in is loaded. After the application closes, the LoadBehavior value changes to 9.


Changing the Registry Setting for Individual Users 

By default, the Plugin is enabled for all users of the Local Machine. 

If you wish to limit it to certain users, you have two options by setting values for the Current User. Setting a value in the Current User will always override the Local Machine values. 

Whitelist (Disable for all users, apart from those you wish to have access) 

  • Disable the Plugin at the Local Machine Level by setting LoadBehaviour = 0 

  • Enable the Plugin at the Current User level by setting LoadBehaviour = 3 

 Blacklist (Block certain users) 

  • Disable the Plugin at the Current User level by setting LoadBehaviour = 0

Applying to all relevant Add-ins

These settings will need to be applied to each add-in as required

˃ [HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Word\Addins\BrochetWordMainAddin]

˃ [HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Word\Addins\BrochetPaste]

˃ [HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Word\Addins\BrochetCrossReferenceTool]