<< Prev appCORE Programming Guide Next >>

NAME

coreMsgFree() -- free message resources.

SYNOPSIS

include "appcore.h"

int coreMsgFree( coreMsg_t* m )

DESCRIPTION

The coreMsgFree() function returns the message's resources back to the system. If the message pool feature is enabled, the message is returned to the appropriate free list in the pool. If the message feature is disabled, the message memory is returned to the heap.

PARAMETERS

m	
	Pointer to message.

RETURN VALUE

If successful, coreMsgFree() returns 0. If an error occurs, -1 is returned and errno is set to one of the following values.

errno ValueCondition
EINVALMessage is null.

MULTI-THREAD SAFETY LEVEL

MT-safe.

SEE ALSO

Functions:
coreMsgCreate(),  coreMsgDup(),  coreMsgDispatch(),  coreMsgForward(),  coreMsgBroadcast(),  coreMsgFlagSet(),  coreMsgFlagIsSet(),  coreMsgFlagClr()
<< Prev appCORE Programming Guide Next >>