If you are running Iguana 4.0 or later, and you get a plugin communication error when you attempt to connect your plugin to Iguana, you must ensure that your plugin is accessing the correct version of the Iguana Communication Library (which is named IGC.dll on Windows). This file, which is included as part of your Iguana installation, is the dynamic link library that implements the communication protocol that your plugin uses to connect to Iguana.

If the wrong version of the Iguana Communication Library is in use, you will see an error message similar to the following:

Plugin communication error encountered: incompatible plugin communication protocol version.  See

http://www.interfaceware.com/manual/plugin_communication_error.html

for an explanation of probable causes of this error.

In Iguana 4.0, the error message looks like this:

Plugin communication error encountered, invalid version or ID. See

http://www.interfaceware.com/manual/plugin_communication_error.html

for an explanation of probable causes of this error.

In either case, a dump, in hexadecimal format, of the incoming data from the invalid connection is also provided. The error will appear in the Iguana logs as an Iguana Service message. In Iguana 4.1, this error message will also appear in the exception that is thrown inside the plugin by the Connect method, which is defined in both the Source and Destination objects.

You will also get a plugin communication error if you attempt to connect to the Iguana plugin communication port with an application that is not a plugin (such as a web browser or the HL7 Simulator). This error looks like this:

Plugin communication error encountered: unrecognized data format.

For information on how to fix these problems, see Fixing Iguana Communication Library Errors.