mesglib.h

Unix环境下的消息队列编程库。

#ifndef _MINE_MESGLIB
#define _MINE_MESGLIB
#include <sys/types.h>

#ifdef MesgLib
#define EXTERN_MSG
#else
#define EXTERN_MSG extern
#endif /* MesgLib */

#define MAXDATALEN	1024

/*
 * These definitions are for mode by which
 * we send or receive messages.
 */
#define NoDelay		  -1
#define BlockDelay	  -2

/*
 * The error code.
 */
#define MECreate	  -1	/* init fail */
#define MESend		  -2	/* sending messages fail */
#define MEReceive	  -3	/* receiving messages fail */
#define MEInvalidID	  -4	/* message ID is invalid */
#define MEInvalidArgu	  -5	/* argument is invalid */

#ifdef __cplusplus
extern "C" {
#endif
/*
 * Initiate messages.
 * nMesgKey is the message key, and return message ID.
 * If nMesgType is negative, will reserve the contents in message;
 * else, clear the contents from message which type is nMesgType;
 * So, if we want to clear all contents, assign 0 into nMesgType.
 */
EXTERN_MSG int initMessages(long nMesgKey, int nMesgType);
/*
 * clear messages.
 * nMesgID is the message ID.
 * Clear the contents from message which type is nMesgType;
 * So, if we want to clear all contents, assign 0 into nMesgType.
 */
EXTERN_MSG int clearMessages(int nMesgID, int nMesgType);
/*
 * Send contents to message specified by nMesgID.
 * nMesgType is the message type.
 * sMessages contains the message contents.
 * length is the size of sMessages.
 * nSendMode specifies the mode of sending.
 */
EXTERN_MSG int sendMessages(int nMesgID, long nMesgType, u_char *sMessages, int length, int nSendMode);
/*
 * Receive contents to message specified by nMesgID.
 * nMesgType is the message type that we want to receive.
 *     If *nMesgType is 0, we will assign the message type of
 *   the first content in message for returning.
 * sMessages contains the message contents.
 *     The size of sMessages must be MAXDATALEN!
 * nRecvMode specifies the mode of receiving.
 */
EXTERN_MSG int recvMessages(int nMesgID, long *nMesgType, u_char *sMessages, int nRecvMode);

EXTERN_MSG int initMsgQueSize(int nMsgId,int nMsgSize);

#ifdef __cplusplus
}
#endif

#endif /* _MINE_MESGLIB */
#define  MaxMsgSize 7168