ham_entity_condition_state()

Уведомить HAM о смене состояния

Прототип:

#include <ha/ham.h>
                                       
int ham_entity_condition_state( ham_entity_t *ehdl,
                                unsigned tostate,
                                unsigned flags );

Аргументы:

ehdl: Дескриптор объекта HAM.
tostate: Значение, указывающее переходное состояние.
flags: Флаги в настоящий момент не поддерживаются.

Данная функция позволяет объекту сообщать о переходе в HAM; значение tostate указывает переходное состояние. HAM, в свою очередь, инициирует событие "состояния условия" для этого объекта, и будет искать соответствующих подписчиков для этого события и выполнять все связанные действия. Дополнительные сведения о механизмах сопоставления см. в документации по API для ham_condition_state().

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

0: Успешное завершение.
-1: Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EBADF: Не удалось подключиться к HAM.
EINVAL: Некорректный дескриптор ehdl. Не удалось подключиться к HAM. Это происходит, когда процесс, открывший соединение (используя ham_connect()), и процесс, вызывающий данную функцию, не совпадают.
ENOENT: Отсутствует объект ehdl.

В дополнение к вышеуказанным ошибкам HAM возвращает любую ошибку, с которой он сталкивается при обслуживании данного запроса.

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

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

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Да

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

ham_condition(), ham_condition_raise(), ham_condition_state(), ham_attach(), ham_attach_self(), ham_entity(), ham_entity_control(), ham_entity_handle(), ham_entity_handle_free(), ham_entity_node()

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