IChatChannelCallBack::OnChannelPropertyChanged

This notification occurs whenever a property on a channel object changes.

Syntax

HRESULT OnChannelPropertyChanged(
   IChatChannel *Channel,
   CHAN_PROP Property,
   VARIANT *Value,
   VARIANT_BOOL PostUpdate,
   long *Cancel);

Function IChatChannelCallBack_OnChannelPropertyChanged( _
   ByVal Channel As CHATSVCLib.IChatChannel, _
   ByVal Property As CHATSVCLib.CHAN_PROP, _
   ByRef Value As Variant,_
   ByVal PostUpdate As Boolean) As Long

Parameters

Channel

Reference to ChatChannel object representing the channel.

Property

A value defined by the CHAN_PROP enumeration, specifying which property is changing.

Value

The value of the property.

PostUpdate

False if this is a pre-update notification. True if the channel property has been changed.

Cancel

Return value. Set to non-zero during the pre-update notification to cancel the operation.

Remarks

The extension can modify the contents of Value during the pre-update notification. The data type of Value should match that defined for the property. See the list of Channel Properties for the expected data type for each property.

This method is not called for changes in channel membership, or for changes in channel security access. To monitor for changes in channel membership, you must bind to the OnAddMember and OnRemoveMember channel event notifications. To monitor for changes in security access for the channel, you must bind to the OnAddAccess and OnRemoveAccess channel event notifications.

© 1998 Microsoft Corporation. All rights reserved.