Babel Home > Babel Plug-in API > Plug-in Reference > Plug-in Messages > COMPLGMSG_STATUS
COMPLGMSG_STATUS Message

The COMPLGMSG_STATUS message is sent to communication plug-ins when the user has ask to change the status of the plug-in.

Syntax

EXTERN EXPORT BOOL PluginCallBack(

    COMPLGMSG_STATUS,     (WPARAM) wParam,     (LPARAM) lParam );

Parameters

wParam
A pointer to a NULL terminated string that describes the reason the user is away, when lParam is equal to BABEL_STAT_AWAY.
lParam
Describes the status the plug-in should change to. This member can be one of the following.
Value Meaning
BABEL_STAT_ONLINE The plug-in should set its status to online.
BABEL_STAT_OFFLINE The plug-in set its status to offline.
BABEL_STAT_AWAY The plug-in should set its status to away for the reason specified by wParam.

Return Value

The plug-in should return a BOOL value, TRUE on success and FALSE on failure. The plug-in should also notify Babel of their status change with the a PLG_UPDATE_STATUS mesage.

Message Information

Headerplugin.h