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 IServerClientVB::Initialize function call.

Notifications are sent in the form of NOTIFY_SERVER_MESSAGE message.

Protected Overridable Sub WndProc (ByRef m As System.Windows.Forms.Message)

(m.HWnd) hParentWnd
(m.Msg) uiMessage,
(m.WParam) wParam
(m.LParam) lParam

Parameters

hParentWnd

Handle to a destination window. It should be passed as parameter to IServerClientVB::Initialize method on initializing interface and point to a form handle that will receive notifications from the IM server.

uiMessage

Identifier of the message that is always equal VBNotification.NOTIFY_SERVER_MESSAGE.

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 specified by m.Result variable is ignored except for notification messages that specify otherwise.

The constants below are defined withinn VBNotification enum defined in the CSCLIENTLib workspace.

Notification Messages passed through wParam variable

AccountPasswordReset	Notifies the IM client application current user's password has been reset on the IM server.
ContactStatus	Notifies the IM client application some user's presence status from the Contact List and/or group contacts has been changed.
ContactListAdded	Notifies the IM client application that new contacts are available to current user on the IM server.
ContactListChanged	Notifies the IM client application that the list of contacts available to current user on the IM server has been changed.
ContactListNeedsToBeRebuilt	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.
ContactListRebuilt	Notifies the IM client application that the user's contacts have been rebuilt on the IM server and must be received again.
GroupAdded	Notifies the IM client application that current user has been added (assigned) to specified messaging group.
GroupChanged	Notifies the IM client application that assigned messaging group has been renamed and/or it's permissions have been changed.
GroupRemoved	Notifies the IM client application that current user has been removed (unassigned) from specified messaging group.
MessageTypingEvent	Notifies the IM client application that remote user is typing a message.
NewMessage	Notifies the IM client application on a new incoming instant message.
SessionClosed	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.
SessionClosedAsExisting	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.
SessionPingPong	Notifies the IM client application that the IM server checks a live status of the application. The IM client may bypass this notification message.

Example

Protected Overrides Sub WndProc(ByRef m As System.Windows.Forms.Message)

    If m.Msg = VBNotification.NOTIFY_SERVER_MESSAGE Then

        Select Case m.WParam.ToInt32()

            Case VBNotification.SessionPingPong

        End Select

    End If

    MyBase.WndProc(m)

End Sub