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

ham_entity_handle_free()

Free a previously obtained handle to an entity

Synopsis:

#include <ha/ham.h>

int ham_entity_handle_free( ham_entity_t *ehdl );

Library:

libham

Description:

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.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

EINVAL
The name given in ename isn't valid.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

Caveats:

The ham_entity_handle_free() function frees storage related only to the handle in the client — it doesn't remove the corresponding entity.

See also:

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