C Netprog Library : MXAddCallBack

NetProg


		NETPROG PRESENTATION
		OverView
		Functionalities
		Programming
			API
			C Examples
		Download

MXAddCallBack

C NetProg Library

#include "mx.h"


	int MXAddCallBack (MX* pmx, char* connectionclassname, char* dialogclassname, char* messclassname, BYTE mode, int (funct)(MXMessage pmessage, MXCom* pcom, void* applicationfield), void* applicationfield)

Parameters	Description
pmx	the MX manager
connectionclassname	the connection class name
dialogclassname	the dialog class name
messclassname	the message class name
mode	the mode that triggers the callback
funct	the function to call when a message is received or sent
applicationfield	Programmer-specified data sent to the callback function

Description :

This function adds a callback to the specified message class callback list. The callback is triggered when a message belonging to (dialogclassname, messclassname) is received or sent on any connection instance belonging to connectionclassname.

The mode parameter can be : MXONRECV, MXONSEND, MXONRECEIVING, MXONSENDING

applicationfield specifies the argument that is to be passed to the specified procedure when it is invoked

Return Values : if error -1 else returns a value > 0.

See Also : MXRemoveCallBack, MXAddGeneralCallBack, MXRemoveGeneralCallBack, MXAddComCallBack, MXRemoveComCallBack

Example :