Skip to content

Set Up API and Macro Security Dialog Box

How do I get to this dialog box?
  1. Open Workspace Settings.

    The steps depend on your user interface mode.

    User Interface Mode Steps
    Ribbon On the File menu or the Reflection button (if using the Office 2007 Look and Feel), choose Reflection Workspace Settings.
    Reflection Browser On the Reflection menu, choose Settings and then Reflection Workspace Settings.
    TouchUx Tap the Gear icon and then select Reflection Workspace Settings.
  2. Under Trust Center, select Set Up API and Macro Security.

From this dialog box, you can enable the Reflection .NET API, and specify corresponding settings.


If you need to use the API in multiple instances of Reflection simultaneously, use layouts. You can specify different settings for the IPC channel name for each layout in the Layout Settings dialog box.

API Settings*

Disable API

Select to prevent custom applications from accessing this installation of Reflection.

Legacy API preference

Use this setting to determine if Reflection legacy macros are supported, and to determine which legacy API has preference for the GetObject() method used to retrieve API COM objects. Reflection supports multiple APIs, but can accept GetObject() calls for only one type of legacy API object at a time.

Select If you...
No Legacy API Don't use legacy Reflection macros, or if your code doesn't use GetObject() to access legacy API COM objects.
Extra! Use GetObject() to access Extra! API COM objects.
Reflection Use legacy Reflection macros, or if you use GetObject() to access legacy Reflection API COM objects. Each session document that you subsequently open or create has legacy macro capability; it includes a legacy VBA project in addition to the standard VBA project in the Visual Basic Editor.
Note: Legacy API support is provided in all Reflection settings files that you open in the workspace (including settings files saved as Reflection session documents), regardless of this setting.

Action Permissions

Specify what you want to happen if an action that has been restricted through Group Policy or the Permissions Manager is initiated through a macro or API call.

Setting Description
Require elevated rights Select to control restricted actions with User Account Control (UAC).
Execute the action Select to run restricted actions that are initiated through a macro or API call as expected. The same actions won't run if they are initiated through the user interface.

More information