tibrvcmEvent_SetExplicitConfirm()
Function
Declaration
tibrv_statustibrvcmEvent_SetExplicitConfirm(
tibrvcmEvent cmListener)
Purpose
Override automatic confirmation of delivery for this listener.
Remarks
The default behavior of certified listeners is to automatically confirm delivery when the callback function returns (see tibrvcmEventCallback). This call selectively overrides this behavior for this specific listener (without affecting other listeners).
By overriding automatic confirmation, the listener assumes responsibility to explicitly confirm each inbound certified message by calling tibrvcmEvent_ConfirmMsg().
Consider overriding automatic confirmation when the processing of inbound messages involves activity that is asynchronous with respect to the message callback method; for example, computations in other threads or additional network communications.
No method exists to restore the default behavior, reversing the effect of this function.
|
Parameter |
Description |
|
|
Override automatic confirmation for this listener. |