Free a previously obtained handle to a condition in an entity
#include <ha/ham.h> int ham_condition_handle_free( ham_condition_t *chdl );
libham
The ham_condition_handle_free() function frees a handle associated with a condition (chdl) and reclaims all storage associated with the given handle.
The handle chdl must be obtained from ham_condition_handle() or ham_condition(). Once a handle is freed, it is no longer available to refer to any condition. The ham_condition_handle_free() call frees storage allocated for the handle itself but does not remove the condition itself, which is in the HAM.
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |
The ham_condition_handle_free() function frees storage related only to the handle in the client — it doesn't remove the corresponding entity.