Microsoft Chat Server SDK Reference

IChatChannelCallBack::OnChangedMember

This method provides notification that channel access is about to change, or has changed for the member.

Syntax

C/C++:
HRESULT OnChangedMember(
   IChatChannel *Channel,
   IChatUser *User,
   CHAT_USER_MODE Mode,
   VARIANT Value,
   VARIANT_BOOL PostUpdate,
   long *Cancel);
Visual Basic:
Function IChatChannelCallBack_OnChangedMember( _
   ByVal Channel As CHATSVCLib.IChatChannel, _
   ByVal User As CHATSVCLib.IChatUser, _
   ByVal Mode As CHATSVCLib.CHAT_USER_MODE, _
   ByRef Value As Variant, _
   ByVal PostUpdate As Boolean) As Long

Parameters

Channel
Reference to ChatChannel object to which the access entry is added.
Entry
Reference to ChatUser object representing member whose access mode is changing.
Mode
A value defined by the CHAT_USER_MODE enumeration. Indicates the intended user mode during pre-update notifications, and defines the new user mode during post-update notifications.
Value
A Boolean value that defines the intent of the mode change. True if member is gaining rights, False if losing them.
PostUpdate
False if this is a pre-update notification. True if the new user access mode has been changed on the server.
Cancel
Return value. Set to non-zero during the pre-update notification to cancel the operation.

Remarks

This notification is triggered whenever a member gains or loses owner, host, or voice rights in a channel. No OnChangedMember event will occur with Mode set to CHAT_CHANNELMEMBER. To monitor for changes in channel membership you must bind to the OnAddMember and OnRemoveMember channel event notifications.

The extension can modify the contents of Value during the pre-update notification.


© 1998 Microsoft Corporation. All rights reserved.