ham_action_fail_remove()

Updated: October 28, 2024

Remove an action-fail item from an action

Synopsis:

#include <ha/ham.h>

int ham_action_fail_remove(
                ham_action_t *ahdl,
                const char *aname,
                unsigned flags);

Arguments:

ahdl
The handle of the HAM action to which the action-fail item was added.
aname
The name of the action-fail item to remove.
flags
Currently not used.

Library:

libham

Description:

The ham_action_fail_remove() function removes an action-fail item from the action identified by ahdl. The aname must match the aname specified when the action-fail item was added.

Returns:

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

Errors:

EBADF
Couldn't connect to the HAM.
EINVAL
Invalid ahdl passed.
ENAMETOOLONG
Invalid aname passed.
ENOENT
There's no action corresponding to the given handle (ahdl), or no action-fail item corresponding to the given name (aname).

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

Classification:

QNX Neutrino

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