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_entity_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_entity_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_entity_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_entity_handle_free.html on line 8
Free a previously obtained handle to an entity
#include <ha/ham.h>
int ham_entity_handle_free( ham_entity_t *ehdl );
libham
The ham_entity_handle_free() function frees a handle associated with
an entity (ehdl) and reclaims all storage associated with the given handle.
The handle (ehdl) must be obtained from
ham_entity_handle(),
ham_attach(), or
ham_attach_self().
Once a handle is freed, it is no longer available to refer to
any condition. The ham_entity_handle_free() call frees storage
allocated for the handle but does not remove the condition
itself, which is in the HAM.
- 0
- Success.
- -1
- An error occurred (errno is set).
- EINVAL
- The name given in ename isn't valid.
QNX Neutrino
Safety: | |
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
The ham_entity_handle_free() function frees
storage related only to the handle in the client — it
doesn't remove the corresponding entity.
ham_action_handle_free(),
ham_condition(),
ham_condition_handle(),
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_entity_handle_free.html on line 131
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_entity_handle_free.html on line 131