ham_condition_handle_free()

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

Прототип:

#include <ha/ham.h>
                                       
int ham_condition_handle_free( ham_condition_t *chdl );

Аргументы:

chdl

Дескриптор условия HAM.

Библиотека:

libham

Описание:

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

Дескриптор условия chdl должен быть получен из ham_condition_handle() или ham_condition(). Как только дескриптор освобожден, он более не доступен для ссылки на какое-либо условие. Вызов ham_condition_handle_free() освобождает память, выделенную для самого дескриптора, но не удаляет само условие, которое находится в HAM.

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

0

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

-1

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

Коды ошибок:

EINVAL

Некорректный дескриптор.

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

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

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

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

Нет

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

Нет

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

Нет

В потоке

Да

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

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

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

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

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