Show Contents / Index / Search

Set Up API and Macro Security Dialog Box

Getting there

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

Note: 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.



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.




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.




Use GetObject() to access legacy EXTRA! API COM objects.

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.

Require elevated rights on Vista; do not execute on XP

On a computer running Windows Vista, select to control restricted actions with User Account Control (UAC).


On a computer running Windows XP, select to prevent restricted actions from running.


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.

Related Topics

Layout Settings Dialog Box

Using Layouts

Security Information for End Users