IP_QueueWrite

IP_QueueWrite — writes a message to a queue.

Syntax

#include <cogent.h>
int IP_QueueWrite(int  qid,
 void*  msg,
 int  length,
 int  priority);

Arguments

qid

A queue ID.

msg

The message buffer to be sent to the queue.

length

The length in bytes of msg.

priority

The priority of this message.

Returns

0 on success, or -1 on failure and errno is set.

Description

This function writes a message to the queue specified by qid. Higher priority numbers are treated as having a higher priority. Priority ordering is not currently implemented. A single write to the queue is limited by the operating system. Queue messages transmitted in a single write will never be broken apart or concatenated with other messages.

See Also

Cascade QueueServer Functions, IP_QueueRead