ham_entity_handle_free()

Освободить дескриптор объекта

Прототип:

#include <ha/ham.h>
                                       
int ham_entity_handle_free( ham_entity_t *ehdl );

Аргументы:

ehdl

Дескриптор объекта HAM.

Библиотека:

libham

Описание:

Функция ham_entity_handle_free() освобождает дескриптор, связанный с объектом (ehdl), и освобождает всю область памяти, связанную с данным дескриптором.

Дескриптор (ehdl) должен быть получен от ham_entity_handle(), ham_attach() или ham_attach_self(). Как только дескриптор освобожден, он более не доступен для ссылки на какое-либо условие. Вызов ham_entity_handle_free() освобождает память, выделенную для дескриптора, однако не удаляет само условие, которое находится в HAM.

Возвращаемое значение:

0

Успешное завершение.

-1

Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EINVAL

Некорректное имя ename.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Предостережения:

Функция ham_entity_handle_free() освобождает область памяти, связанную исключительно с дескриптором в клиенте — она не удаляет соответствующий объект.

Тематические ссылки:

ham_action_handle_free(), ham_condition(), ham_condition_handle(), ham_entity_handle_free()

Предыдущий раздел: Менеджер высокой готовности (HAM)