Destroy the specified channel based on the channel ID.
BPS_API int bps_channel_destroy(int chid)
The channel ID set by a call to the bps_channel_create() function.
After an application is finished using the channel, call the bps_channel_destroy() function for channels that are created using the bps_channel_create() function. After this function is called, all events that are waiting in the channel's event queue are completed and all callbacks registered with the bps_register_channel_destroy_handler() function are called.
When the chid argument is the thread's active channel, it is destroyed and the default channel for the thread is set as the active channel.
BPS_SUCCESS when the function completes successfully, BPS_FAILURE with errno value set otherwise.