tibrvcmEvent
Type
Declaration
typedef tibrvId tibrvcmEvent
;
Purpose
A certified delivery event object listens for labeled messages and certified messages.
Remarks
Each call to the event creation function tibrvcmEvent_CreateListener() results in a new certified delivery event object, which represents your program’s listening interest in a stream of labeled messages and certified messages. Rendezvous software uses the same event object to signal each occurrence of such an event.
Programs use the event object as a token; they cannot view or modify the object, except using accessor functions.
Programs must explicitly destroy each certified delivery event object using tibrvcmEvent_Destroy(). Destroying a certified listener object cancels the program’s immediate interest in that event, and frees its storage; nonetheless, a parameter to the destroy call determines whether certified delivery agreements continue to persist beyond the destroy call.
See Also
tibrvcmEvent_GetListenerSubject()
tibrvcmEvent_GetListenerTransport()