Plug-in Information dialog

Dialogs Overview


This dialog is used for displaying and specifying plug-in information.


Module Name

The name of the plug-in module in the same folder as the Asprova executable file is displayed.

 1. It is loaded, and if the function is enabled, this item is ticked.
 2. If you deselect this item, the plug-ins (including EII) installed in that plug-in module are ignored.
 3. From Ver. 13.1, plug-in modules that are not registered in the OS are displayed with no check mark. If you have administrator privilege, you can perform registration (*1) to the OS by selecting the check box of the item if it is not ticked.
In that case, you do not need to run regsvr32.exe or regasm.exe. (Ver.14 restricted feature)

? 1 Registry registration with regsvr32.exe or regasm.exe

Function Name

Call names that can be used for the plug-in currently selected in the Module Name list box.
Detailed information about the plug-in function selected by a module name and call name will be displayed in the upper right corner of the dialog.

Plug-in Manager Version

Version of the currently used plug-in manager.

Load only plug-in in the same folder as Asprova

When the checkbox of this item is selected, only the plug-in in the same folder as the Asprova executable file is loaded to the memory.
When this checkbox is not selected, only the plug-in registered last is loaded to the memory if a plug-in of the same name as the plug-in in the same folder as the Asprova executable file is in another folder on that machine.

Example: When a plug-in with the same file name is located in the same folder as the Asprova executable file (plug-in A), and a different folder exists on that machine (plug-in B)
Load only plug-in in the same folder as AsprovaPlug-in registered to registry = APlug-in registered to registry = B
Check box selectedThe check box of the module name is selected, and plug-in A is loaded.The check box of the module name is not selected, and neither plug-in A nor plug-in B is loaded.
If the checkbox is selected again, plug-in A is loaded (administrator privilege is required).
Check box not selectedThe check box of the module name is selected, and plug-in A is loaded.The check box of the module name is selected, and plug-in B is loaded.

However, DLLs created with .NET may not be supported by “Load only plug-in in the same folder as Asprova”
. To restrict plug-ins created with .NET to the same folder as Asprova, you need to create DLLs by the following procedure.

1. When creating a plug-in, sign the assembly.

2. When registering a plug-in with RegAsm.exe in the registry, add -CodeBase to an argument prior to execution.

For details, refer to TN-C17022301 in the technical notes of COM SDK (Technical Notes.pdf).

Hide Mainframe for Automation Call

If you check this box, Asprova will be hidden when it is started from an automation client.

Start Multi Instances by Automation client (Ver.13 restricted feature)

Selecting the check box will allow multiple Asprova.exe processes to be run from the automation client.

If this check box is selected, any plugins that are in use must create instances of COM objects using the CreateXXXX methods of the CASRootObject class, regardless of whether a single or multiple instances of Asprova are to be started.

If you use CreateInstance in C++, New in VB, or new in C# instead of this method, runtime error may result.

For details, see the plugin manual (Basics) in the COM SDK.
For the creation methods of COM objects, see here.

Redo Auto-Registration

Reloads the plug-in module.

EII Settings

Displays the EII (Extension Interface Implementation) Setup dialog.

Check All

Select all the check boxes in this dialog box.

Uncheck All

Deselect all the check boxes in this dialog box.

EII Setup Dialog

Clicking on the EII Setting button in the Plug-in Information dialog displays the EII Setup dialog.


EII Interface

List of usable EII interfaces.

EII Implementation

List of EIIs implemented as plug-ins for the interface selected in the EII Interface combo box.

EII Interface Information

Information about the EII interface selected in the EII Implementation list box.

EII Implementation Information

Information about the implementation of the EII interface selected in the EII Implementation list box.


*You can call only a single EII implementation for an EII interface. When you open this dialog for the first time, all the implementations are selected.However, only the EII implementation at the top of the list will be called.

 

Automatic setting of plug-ins with drag & drop

To be able to use the plug-ins that you have created, you need to perform procedures such as DLL arrangement and registration to the registry.

File arrangement and registry registration are done by dragging and dropping the DLL created in the Plug-in information dialog box (Ver. 13 restricted feature).

Enable Auto-Registration

Drag and drop the DLL file on the Plug-in information dialog.

 

Once the plug-in is corrected registered, a message such as the following is displayed.

 

When auto arrange of plug-in does not end normally

If auto arrange of the plug-in does not end normally due to a problem, an error message such as the following will be displayed.

 

The content of this message will differ according to the nature of the problem. After confirming the content of the message, please find a workaround.

Message content

Failed to copy xxx.dll because there is not Administrator privilege. Please restart Asprova.exe with Administrator privilege and try again.

Please restart Asprova.exe with Administrator privilege and then execute auto arrange of the plug-in again.


The copy source xxx.dll is already in the folder of Asprova.exe. Will not copy it.

Check whether the copy source xxx.dll is correct (check that you have not selected a file that is already in the copy destination folder.)


Failed to copy file because failed to access to the network drive.

If the copy source is a network drive, either log in to that drive or copy the file locally first and then execute auto arrange of that plug-in again, but using the local file.


Could not open the file Failed to replace the file. Maybe it was because the file xxx.dll is being used. Please close Asprova.exe, delete the file then try again.

A DLL of the same name may already be loaded in Asprova as a plug-in. Exit Asprova (do so after checking that no Asprova processes are running), then delete the DLL at the copy destination, and again execute auto arrange of the plug-in.


Failed to register the plugin xxx.dll into the Registry because there is no Administrator privilege. Please restart Asprova.exe with Administrator privilege and try again.

Launch Asprova as an administrator and then execute auto arrange of the plug-in again.


64bit Asprova.exe cannot use 32bit plugin xxx.dll. Please replace them with the corresponding 64-bit version plug-ins.

The copy source DLL is a 32-bit DLL. Prepare the 64-bit DLL, then execute auto arrange of the plug-in again.


32bit Asprova.exe cannot use 64bit plugin xxx.dll. Please replace them with the corresponding 32-bit version plug-ins.

The copy source DLL is a 64-bit DLL. Prepare the 32-bit DLL, then execute auto arrange of the plug-in again.


Failed to register the plugin xxx.dll into the Registry because Interop.AsPlugInManager.dll or Interop.AsLib.dll is not found.

In the case of DLLs created with .NET nterop.AsPlugInManager.dll and Interop.AsLib.dll are required. Prepare these in advance, then execute auto arrange of the plug-in again.


Failed to register the plugin xxx.dll into the Registry

The following reasons are possible. Please check each of them.

-The dll file is broken.

-The interface ASDefault is not implemented in the dll file.

-dll file has a different name from the plugin's project file.

The dll file is broken.

-The interface ASDefault is not implemented in the dll file.

-dll file has a different name from the plugin's project file.

-.Net Framework is not installed.

-Interop.AsPlugInManager.dll's or Interop.AsLib.dll's version is not correct.

-If Interop.AsPlugInManager.dll or Interop.AsLib.dll was copied and pasted while Asprova.exe was already running, Asprova.exe must be restarted.


For further details about plug-in development, please see the COM SDK documentation.
(During the installation of Asprova, the COM SDK documentation is also installed.)

 


HelpNo.:737900
© 2017 Asprova Corporation, All rights reserved.