MsgVerifyEvent(), MsgVerifyEvent_r()

Проверить корректность идентификатора и конфигурации события

Прототип:

#include <sys/neutrino.h>
int MsgVerifyEvent( int rcvid,
const struct sigevent event );
int MsgVerifyEvent_r( int rcvid,
const struct sigevent event );

Аргументы:

rcvid
Идентификатор сообщения, который нужно проверить.
event
Указатель на структуру a struct sigevent, содержащую событие, которое нужно проверить.

Библиотека:

libc

Описание:

Функции MsgVerifyEvent() и MsgVerifyEvent_r() проверяют корректность идентификатора сообщения rcvid и конфигурации event. Эти функции можно использовать для верификации, корректно ли сформировано событие, как на стороне клиента (передать rcvid равный 0), так и на стороне сервера (указать rcvid, связанный с клиентским потоком).

Данные функции идентичны за исключением способа возврата ошибок.

Состояния блокировки:

Отсутствуют.

Возвращаемое значение:

MsgVerifyEvent()
Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.
MsgVerifyEvent_r()
Функция НЕ устанавливает errno. При возникновении ошибки функция возвращает один из представленных ниже кодов.

Коды ошибок:

EBADF
Отсутствует канал для доставки импульса.
EINVAL
Некорректная структура event.
ESRCH
Отсутствует соединение для отправки импульса.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

MsgReceive(), MsgReceivev(), MsgReply(), MsgSend(), MsgSendv(), MsgWrite(), MsgWritev(), struct sigevent




Предыдущий раздел: Описание API системной библиотеки