IChatServerCallBack::OnNewUser

This notification indicates that a new user has registered with the server.

Syntax

HRESULT OnNewUser(
   IChatUser *User,
   VARIANT_BOOL PostUpdate,
   long *Cancel);

Function IChatServerCallBack_OnNewUser( _
   ByVal User As CHATSVCLib.IChatUser, _
   ByVal PostUpdate As Boolean) As Long

Parameters

User

Reference to ChatUser object representing the new user session.

PostUpdate

False if this is a pre-update notification. True if new user 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 authenticated the user name and password but before the acknowledgement is sent back to the user and before the user is visible to any other aspect of the server. The extension can therefore re-authenticate against the extension's own user database, validate any of the user properties (such as to check the user profile and nickname for profanity), and effect the completion of the event as necessary.

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

See Also

AddUserEvent

© 1998 Microsoft Corporation. All rights reserved.