ham_action_remove()

Updated: May 06, 2022

Remove an action from a condition

Synopsis:

#include <ha/ham.h>

int ham_action_remove( ham_action_t *ahdl,
                       unsigned flags);

Arguments:

ahdl
The HAM action handle to remove.
flags
Currently not used.

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:

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

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