Registering for events

In addition to the event classes, the Event Management Framework uses a registration data class (SOMEEMRegisterData) to capture all event-related registration information. The procedure for registering interest in an event is as follows:

• Create an instance of the SOMEEMRegisterData class (this will be referred to as a "RegData" object).

• Set the event type of "RegData."

• Set the various fields of "RegData" to supply information about the particular event for which an interest is being registered.

• Call the registration method of EMan, using "RegData" and the callback method information as parameters. The callback information varies, depending upon whether it is a simple procedure, a method called using OIDL call style, or a method called using IDL call style.

The following code segment illustrates how to register input interest in a socket "sock" and provide a callback procedure "ReadMsg".

data = SOMEEMRegisterDataNew( );       /* create a RegData object */_someClearRegData(data, Ev);
_someSetRegDataEventMask(data,Ev,EMSinkEvent,NULL); /* Event type */
_someSetRegDataSink(data, Ev, sock);     /* provide the socket id */
_someSetRegDataSinkMask(data,Ev, EMInputReadMask );
                                                 /*input interest */
regId = _someRegisterProc(some_gEMan,Ev,data,ReadMsg,"UserData" );
/* some_gEMan points to EMan. The last parameter "userData" is any
   data the user wants to be passed to the callback procedure as a
   second parameter */