iCore Events via RemoteInput Object (COM/DCOM)
ERemoteInput-object allows you to create an iCore Event from tools that can call automation objects. It uses the same object as iCoreTrig.exe.
ERemoteEvent supports IErrorInfo. We strongly recommend using this mechanism whenever a method returns an HResult other than S_OK.
Identifiers
| CLSID_ERemoteEvent | Global unique identifier (GUID) for object. |
| IID_IERemoteEvent | Global unique identifier (GUID) for interface. |
Methods
| Init | Initiates the RemoteInput-object. Init must be called before other methods. |
| BeginEvent | Starts a new Event. |
| BeginEventEx | Starts a new Event that allows several parameters. |
| BeginEventEx2 | Starts a new Event that allows several parameters. BeginEventEx2 is a version of BeginEventEx, that can be called even if the datatype DATE is not supported. |
| CommitEventSync | Performs a synchronous Event. |
| CommitEventAsync | Performs an asynchronous Event. |
| CommitEventAsync2 | Performs an asynchronous Event. A version of CommitEventAsync that can be called even if the datatype VARIANT_BOOL is not supported. |
| RollbackEvent | Aborts a non-committed Event (an event started by a BeginEvent or BeginEventEx call, but not performed by CommitEventSync or CommitEventAsync). |
| SetDataAttrib | Sets the value of an attribute to data (a Node) sent with the Event. Valid attribute is iCoreDA_NodeName. |
| SendData | Sends text data to be sent with the Event (creates a Node and writes data to Node file). |
| SendDataEx | Sends text data with character set identifier to be sent with the Event (creates a Node and writes data to Node file). |
| SendBinaryData | Sends binary data to be sent with the Event (creates a Node and writes data to Node file). |
note
Only one Node is created per Event.
note
You can use either SendData or SendBinaryData for each Begin/Commit (not both).
Maximum size of Event parameters
The maximum size of serialized Event parameters is 4 MB. This limitation derives from MSMQ and applies to all functions that create an Event, including return values sent via a synchronuous Event and functions that send responses via iCore API.