MsgUnregisterEvent(), MsgUnregisterEvent_r()
QNX SDP8.0C Library ReferenceAPIDeveloper
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 any value from the Errors section.
Errors:
- ESRCH
- The event associated with the handle couldn't be found.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: