MsgUnregisterEvent(), MsgUnregisterEvent_r()

Updated: October 26, 2022

Unregister a secure event

Synopsis:

#include <sys/neutrino.h>

int MsgUnregisterEvent( const struct sigevent *event );

int MsgUnregisterEvent_r( const struct sigevent *event );

Arguments:

event
A pointer to the sigevent that contains the handle of the secure event that you want to unregister.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The MsgUnregisterEvent() and MsgUnregisterEvent_r() kernel calls unregister the secure event associated with the given handle. These functions are identical except in the way they indicate errors. See the Returns section for details.

To register an event, call MsgRegisterEvent(). For more information about secure events, see Events in the “Interprocess Communication (IPC)” chapter of the System Architecture guide.

Blocking states

None.

Returns:

The only difference between MsgUnregisterEvent() and MsgUnregisterEvent_r() is the way they indicate errors:

MsgUnregisterEvent()
If successful, this function returns EOK. If an error occurs, it returns -1 and sets errno.
MsgUnregisterEvent_r()
If successful, this function returns EOK. This function does NOT set errno, even on success. If an error occurs, it may return the negative of any value from the Errors section.

Errors:

ESRCH
The event associated with the handle couldn't be found.

Classification:

QNX Neutrino

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