TibrvEvent.destroy()
Method
Declaration
void destroy()
Purpose
Destroy an event, canceling interest.
Remarks
Destroying an event object cancels interest in it. Upon return from TibrvEvent.destroy(), the destroyed event is no longer dispatched. However, all active callback methods of this event continue to run and return normally, even though the event is invalid.
It is legal for an event callback method to destroy its own event argument.
Destroying event interest invalidates the event object; subsequent API calls involving the invalid event throw exceptions, unless explicitly documented to the contrary.