IChatServerCallBack::OnNewChannel

This notification allows extensions to modify any of the channel properties or to cancel the creation of a dynamic channel.

Syntax

HRESULT OnNewChannel(
   IChatChannel *Channel,
   VARIANT_BOOL PostUpdate,
   long *Cancel);

Function IChatServerCallBack_OnNewChannel(_
   ByVal Channel As CHATSVCLib.IChatChannel, _
   ByVal PostUpdate As Boolean) As Long

Parameters

Channel

Reference to new ChatChannel object.

PostUpdate

False if this is a pre-update notification. True if channel has been committed to the server.

Cancel

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

Remarks

The pre-update invocation occurs when the server has created the channel object but before the channel is visible to any other aspect of the server. The extension can therefore validate any of the channel properties as necessary, such as to check the channel topic for profanity, and effect the completion of the event as necessary.

The extension can register for further channel-related event notifications during the processing of this event.

See Also

AddChannelEvent

© 1998 Microsoft Corporation. All rights reserved.