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.
RequestSwitchboardOverloaded. Sends a request to the server to start a new switchboard session.
SendMobileMessageOverloaded. 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.
GetMSNListOverloaded. 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.
ParseStatusOverloaded. 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