ham_action_remove()

Remove an action from a condition

Synopsis:

#include <ha/ham.h>

int ham_action_remove( ham_action_t *ahdl,
                       unsigned flags);

Library:

libham

Description:

You use the ham_action_remove() function to remove an action from a condition in a specific entity.

You can obtain the handle (ahdl) either:

• from one of the ham_action*() functions that add actions

  or:

• by calling ham_action_handle() to request a handle to a specific condition.

The flags argument isn't currently used.

Returns:

0

Success.

-1

An error occurred (errno is set).

Errors:

EBADF

Couldn't connect to the HAM.

EINVAL

The handle passed is invalid.

The connection to the HAM is invalid. This happens when the process that opened the connection (using ham_connect()) and the process that's calling ham_action_remove() aren't the same.

ENOENT

There's no action corresponding to the given handle (ahdl).

In addition to the above errors, the HAM returns any error it encounters while servicing this request.

Classification:

QNX Neutrino

See also:

ham_action_execute(), ham_action_handle(), ham_action_heartbeat_healthy(), ham_action_log(), ham_action_notify_pulse(), ham_action_notify_signal(), ham_action_restart(), ham_action_waitfor()