Notifications

---

Notifications are the messages that sent to a parent window of the IM client application and notify about any events initiated by the IM server. Notifications deliver information on incoming and forwarded instant messages, changes in the user's Contact List, adding/removing assigned messaging groups, changing group permissions, etc. The handle to the window of the application that should receive these notifications is set through the IServerClient::Initialize function call.

Notifications are sent in the form of WM_NOTIFY_SERVER message.

lResult = SendMessage(
    (HWND) hParentWnd,
    (UINT) WM_NOTIFY_SERVER,
    (WPARAM) wParam,
    (LPARAM) lParam
);

Parameters

hParentWnd

Handle to a destination window.

wParam

Identifier of the notification message. See available notification messages in the table below.

lParam

Contains additional information and data depending on the notification message.

Return Value

The return value is ignored except for notification messages that specify otherwise.

Notification Messages

NOTIFY_ACCOUNT_PASSWORD_RESET	Notifies the IM client application current user's password has been reset on the IM server.
NOTIFY_CONTACT_STATUS	Notifies the IM client application some user's presence status from the Contact List and/or group contacts has been changed.
NOTIFY_CONTACTS_ADDED	Notifies the IM client application that new contacts are available to current user on the IM server.
NOTIFY_CONTACTS_CHANGED	Notifies the IM client application that the list of contacts available to current user on the IM server has been changed.
NOTIFY_CONTACTS_NEEDS_TO_REBUILD	Notifies the IM client application that the user's contacts have been reset due to major changes in the users structure on the IM server.
NOTIFY_CONTACTS_REBUILT	Notifies the IM client application that the user's contacts have been rebuilt on the IM server and must be received again.
NOTIFY_FILE_STATUS	Notifies the IM client application on a status of currently transmitting file transfer including amount of sent/received data and current progress. This notification is sent continiously while the file transfer process occurs.
NOTIFY_FORWARD_MESSAGE	Notifies the IM client application on a forwarded instant message to a single recipient which has been sent from a remote IM client application that uses the same user account.
NOTIFY_FORWARD_MULTIPLE_MESSAGE	Notifies the IM client application on a forwarded instant message to multiple recipients which has been sent from a remote IM client application that uses the same user account.
NOTIFY_GROUP_ADDED	Notifies the IM client application that current user has been added (assigned) to specified messaging group.
NOTIFY_GROUP_ADDED_BY_USER	Notifies the IM client application that current user has been added (assigned) to several specified messaging groups.
NOTIFY_GROUP_CHANGED	Notifies the IM client application that assigned messaging group has been renamed and/or it's permissions have been changed.
NOTIFY_GROUP_CHANGED_BY_USER	Notifies the IM client application that several assigned messaging groups have been renamed and/or their permissions have been changed.
NOTIFY_GROUP_REMOVED	Notifies the IM client application that current user has been removed (unassigned) from specified messaging group.
NOTIFY_GROUP_REMOVED_BY_USER	Notifies the IM client application that current user has been removed (unassigned) from several specified messaging groups.
NOTIFY_MESSAGE_TYPING_EVENT	Notifies the IM client application that remote user is typing a message.
NOTIFY_NEW_MESSAGE	Notifies the IM client application on a new incoming instant message.
NOTIFY_NEW_TRANSFER	Notifies the IM client application on a new incoming file transfer request.
NOTIFY_SESSION_CLOSED	Notifies the IM client application that the connection with the IM server has been lost and the session has been closed. This can be a result of network issues or the IM server forcefully closes the session.
NOTIFY_SESSION_CLOSED_AS_EXISTING	Notifies the IM client application that the connection with the IM server has been automatically interrupted and the session has been closed. This can be a result of another connection to the IM server made under the same user account.
NOTIFY_SESSION_PINGPONG	Notifies the IM client application that the IM server checks a live status of the application. The IM client may bypass this notification message.