tibrvTransport_Destroy()
Function
Declaration
tibrv_statustibrvTransport_Destroy(
tibrvTransport transport);
Purpose
Remarks
Programs must explicitly destroy each transport object.
Destroying a transport achieves these effects:
| • | The transport flushes all outbound data to the Rendezvous daemon. |
This effect is especially important, and neither exiting the program nor calling tibrv_Close() is sufficient to flush outbound data.
| • | The transport invalidates all its listeners. |
| • | Subsequent calls that use the destroyed transport return an error status. |
| • | Storage for the transport object is freed. |
It is illegal to destroy the intra-process transport (TIBRV_PROCESS_TRANSPORT); attempting to destroy it produces the status code TIBRV_NOT_PERMITTED.
|
Parameter |
Description |
|
|
Destroy this transport. |