Installing a Plug-in using Configuration

A plug-in can be installed into a communicator using a configuration property of the following form:

CODE


Ice.Plugin.Name=entry_point [arg ...]

Most plug-ins accept only one specific name, so make sure to use the plug-in’s name for Name.

In C++ and C++-based language mappings, entry_point consists of the path name of the shared library or DLL containing the factory function, along with the name of the factory function.

For example:

CODE

Ice.Plugin.CustomLogger=customlogger:createCustomLogger logLevel=Debug

The Ice.Plugin.* property reference describes entry_point in greater detail.

After extracting the plug-in's entry point from the property value, any remaining text is parsed using semantics similar to that of command-line arguments. Whitespace separates the arguments, and any arguments that contain whitespace must be enclosed in quotes:

CODE

Ice.Plugin.MyPlugin=entry_point --load "C:\Data Files\config.dat"

Ice passes these arguments to the plug-in during construction.

See Also