Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 8
Free a previously obtained handle to an action in a condition in an entity
#include <ha/ham.h>
int ham_action_handle_free(ham_action_t *ahdl);
libham
The ham_action_handle_free() function frees a
handle (ahdl) associated with a given action in a
condition in an entity. The function reclaims all storage associated with the handle.
The handle you pass as an argument (ahdl) must be obtained from
ham_action_execute(),
ham_action_restart(),
ham_action_notify_pulse(),
ham_action_notify_signal(), or ham_action_waitfor().
Once a handle is freed, it is no longer available to refer to
any action. The ham_action_handle_free() call frees storage
allocated for the handle, but does not remove the action
itself, which is in the HAM.
- 0
- Success.
- -1
- An error occurred (errno is set).
- EINVAL
- The handle isn't valid.
QNX Neutrino
Safety: | |
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
The ham_action_handle_free() function frees
storage related only to the handle in the client — it doesn't
remove the corresponding action.
ham_action_execute(),
ham_action_handle(),
ham_action_restart(),
ham_action_notify_pulse(),
ham_action_notify_signal(),
ham_action_waitfor(),
ham_condition_handle_free(),
ham_entity_handle_free()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 138
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/ham_en/ham/hamapi/ham_action_handle_free.html on line 138