DotMSN |

# NSMessageHandler Members

NSMessageHandler overview

#### Public Instance Properties

AutoSynchronize | Defines if the contact list is automatically synchronized upon connection.
ConnectivitySettings | If WebProxy is set the Webproxy is used for the authentication with Passport.com
ContactGroups | A collection of all contactgroups which are defined by the user who logged into the messenger network.\
ContactList | A collection of all contacts which are on any of the lists of the person who logged into the messenger network
Credentials | These credentials are used for user authentication and client identification
ExternalEndPoint | The end point as perceived by the server. This is set after the owner's profile is received.
IsSignedIn | Defines whether the user is signed in the messenger network
MessageProcessor | The processor to handle the messages
Owner | The owner of the contactlist. This is the identity that logged into the messenger network.

#### Public Instance Methods

AddContactGroup | Send a request to the server to add a new contactgroup.
AddContactToList | Send a request to the server to add this contact to a specific list.
AddNewContact | Creates a new contact and sends a request to the server to add this contact to the forward and allowed list.
BlockContact | Block this contact. This way you don't receive any messages anymore. This contact will be removed from your allow list and placed in your blocked list.
ChangeGroup | Moves a contact from the current contact group to a new contact group.
Equals (inherited from Object) | Determines whether the specified Object is equal to the current Object.
GetHashCode (inherited from Object) | Serves as a hash function for a particular type. GetHashCode is suitable for use in hashing algorithms and data structures like a hash table.
GetType (inherited from Object) | Gets the Type of the current instance.
HandleMessage | Handles message from the processor.
RemoveContact | Remove the specified contact from your forward and allow list. Note that remote contacts that are blocked remain blocked.
RemoveContactFromList | Send a request to the server to remove a contact from a specific list.
RemoveContactGroup | Send a request to the server to remove a contactgroup. Any contacts in the group will also be removed from the forward list.
RenameGroup | Set the name of a contact group
RequestScreenName | Send the server a request for the contact's screen name.
RequestSwitchboard | Overloaded. Sends a request to the server to start a new switchboard session.
SendMobileMessage | Overloaded. Sends a mobile message to the specified remote contact. This only works when the remote contact has it's mobile device enabled and has MSN-direct enabled.
SetMobileAccess | Sets whether the contact list owner allows remote contacts to send messages to it's mobile device.
SetMobileDevice | Sets whether the contact list owner has a mobile device enabled.
SetNotifyPrivacyMode | Set the contactlist owner's notification mode.
SetPhoneNumberHome | Sets the telephonenumber for the contact list owner's homephone.
SetPhoneNumberMobile | Sets the telephonenumber for the contact list owner's mobile phone.
SetPhoneNumberWork | Sets the telephonenumber for the contact list owner's workphone.
SetPresenceStatus | Set the status of the contactlistowner (the client). Note: you can only set the status _after_ you have synchronized the list using SynchronizeList(). Otherwise you won't receive online notifications from other clients or the connection is closed by the server.
SetPrivacyMode | Set the contactlist owner's privacy mode.
SetScreenName | Sets the contactlist owner's screenname. After receiving confirmation from the server this will set the Owner object's name which will in turn raise the NameChange event.
SynchronizeContactList | Send the synchronize command to the server. This will rebuild the contactlist with the most recent data.
ToString (inherited from Object) | Returns a String that represents the current Object.
UnBlockContact | Unblock this contact. After this you are able to receive messages from this contact. This contact will be removed from your blocked list and placed in your allowed list.

#### Public Instance Events

AuthenticationError | Occurs when the user could not be signed in due to authentication errors. Most likely due to an invalid account or password. Note that this event will also raise the more general ExceptionOccurred event.
ContactAdded | Occurs when a contact is added to any list (including reverse list)
ContactGroupAdded | Occurs when a new contactgroup is created
ContactGroupChanged | Occurs when a contactgroup property is changed
ContactGroupRemoved | Occurs when a contactgroup is removed
ContactOffline | Occurs when any contact goed from any status to offline status
ContactOnline | Occurs when any contact goes from offline status to another status
ContactRemoved | Occurs when a contact is removed from any list (including reverse list)
ContactStatusChanged | Occurs when any contact changes status
ExceptionOccurred | Occurs when an exception is thrown while handling the incoming or outgoing messages
MailboxChanged | Occurs when unread mail is read or mail is moved by the Owner.
MailboxStatusReceived | Occurs when the server notifies the client with the status of the owner's mailbox.
NewMailReceived | Occurs when new mail is received by the Owner.
PingAnswer | Occurs when an answer is received after sending a ping to the MSN server via the SendPing() method
ReverseAdded | Occurs when another user adds us to their contactlist. A ContactAdded event with the reverse list as parameter will also be raised.
ReverseRemoved | Occurs when another user removes us from their contactlist. A ContactRemoved event with the reverse list as parameter will also be raised.
SBCreated | Occurs when a switchboard session has been created
ServerErrorReceived | Occurs when the the server send an error.
SignedIn | Occurs when the authentication and authorzation with the server has finished. The client is now connected to the messenger network.
SignedOff | Occurs when the message processor has disconnected, and thus the user is no longer signed in.
SynchronizationCompleted | Occurs when a call to SynchronizeList() has been made and the synchronization process is completed. This means all contact-updates are received from the server and processed.

#### Protected Instance Methods

Clear | Clears all resources associated with a nameserver session.
CreateSBHandler | Gets a new switchboard handler object. Called when a remote client initiated the switchboard.
Finalize (inherited from Object) | Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
GetMSNList | Overloaded. Translates the codes used by the MSN server to a MSNList object.
HashMD5 | This function implements the MD5 algorithm as is used by microsoft messenger.
MemberwiseClone (inherited from Object) | Creates a shallow copy of the current Object.
OnADDReceived | Called when a ADD command has been received.
OnADGReceived | Called when an ADG command has been received.
OnAuthenticationErrorOccurred | Fires the AuthenticationError event.
OnBLPReceived | Called when a BLP command has been received.
OnBPRReceived | Called when a BPR command has been received.
OnCHGReceived | Called when a CHG command has been received.
OnCHLReceived | Called when a CHL (challenge) command message has been received.
OnCVRReceived |
OnExceptionOccurred | Fires the ExceptionOccurred event.
OnFLNReceived | Called when a FLN command has been received.
OnGTCReceived | Called when a GTC command has been received.
OnILNReceived | Called when a ILN command has been received.
OnLSGReceived | Called when a LSG command has been received.
OnLSTReceived | Called when a LST command has been received.
OnMailboxStatusReceived | Called when the server sends the status of the owner's mailbox.
OnMailChanged | Called when the owner has removed or moved e-mail.
OnMailNotificationReceived | Called when the owner has received new e-mail, or e-mail has been removed / moved. Fires the NewMailReceived event.
OnMSGReceived | Called when a MSG command has been received.
OnNLNReceived | Called when a NLN command has been received.
OnNOTReceived | Called when a NOT command has been received.
OnOUTReceived | Called when an OUT command has been received.
OnProcessorConnectCallback | Called when the message processor has established a connection. This function will begin the login procedure by sending the VER command.
OnProcessorDisconnectCallback | Called when the message processor has disconnected.
OnProfileReceived | Called when the server has send a profile description. This will update the profile of the Owner object.
OnPRPReceived | Called when an PRP command has been received.
OnQNGReceived | Called when a QNG command has been received.
OnREAReceived | Called when a REA command has been received.
OnREGReceived | Called when a REG command has been received.
OnREMReceived | Called when a REM command has been received.
OnRMGReceived | Called when a RMG command has been received.
OnRNGReceived | Called when a RNG command has been received.
OnSBCreated | Fires the ExceptionOccurred event.
OnServerErrorReceived | Fires the ServerErrorReceived event.
OnSignedIn | Fires the SignedIn event.
OnSignedOff | Fires the SignedOff event.
OnSYNReceived | Called when a SYN command has been received.
OnUSRReceived |
OnVERReceived |
OnXFRReceived | Called when a XFR command has been received.
ParseStatus | Overloaded. Translates messenger's textual status to the corresponding value of the Status enum.
SendInitialMessage | Send the first message to the server. This is usually the VER command.

#### See Also

NSMessageHandler Class | XihSolutions.DotMSN Namespace