tibrvcmTransport_Destroy()

Function

Declaration

tibrv_status tibrvcmTransport_Destroy(
    tibrvcmTransport    cmTransport); 
tibrv_status tibrvcmTransport_DestroyEx(
    tibrvcmTransport            cmTransport,
    tibrvcmTransportOnComplete  completionFunction,
    void*                       closure);

Purpose

Destroy a certified delivery transport.

Parameter

Description

cmTransport

Destroy this transport.

completionFunction

Rendezvous software runs this function immediately after all queued tasks are complete.

Do not destroy the transport’s listeners until after this callback signals that cleanup has completed.

See tibrvcmTransportOnComplete.

closure

Pass this closure data to the completion function.

Remarks

Destroying a certified delivery transport with a file-based ledger always leaves the ledger file intact; it neither erases nor removes a ledger file.

Distributed Queue

To destroy a distributed queue transport, call tibrvcmTransport_DestroyEx(). With the ordinary destroy call, the distributed queue can lose reliable (non-certified) task messages before they are processed. The distributed queue needs the listeners, queues and dispatchers (associated with the transport) to remain operational—programs must wait until after the transport has been completely destroyed before destroying these associated objects.

See Also

tibrvcmTransportOnComplete

tibrvcmTransport_Create()

tibrvcmTransport_CreateDistributedQueue()