Functions:

	AddContact
	
	Launches the Add a Contact wizard to the screen used for adding a contact, as designated
	by the input parameter.     
	If SigninName isn't suplied the Add a Contact wizard remains displayed for the user to
	input the value.
		  
	Parameters:
		[SigninName]


	AutoSignin
	
	Logs the local client back on automatically using the last sign-in name and saved password
	information.
	

	get_MyFriendlyName
	
	Retrieves the friendly (display) name of the local client user.
		
	
	get_MyPhoneNumber
	
	Retrieves the stored phone number of the local client user. 

	Parameters:
		[Phonetype]
			0 - Get home phone number (default).
			1 - Get work phone number.
			2 - Get mobile phone number.


	get_MyServiceID

	Retrieves the service ID, a globally unique identifier (GUID), of the primary service to
	which the local client user is currently signed in. 


	get_MyServiceName

	Retrieves the service name of the primary service to which the local client user is 
	currently signed in.
  

	get_MySigninName

	Retrieves the sign-in name of the local client user.


	get_MyStatus

	Retrieves the connection state of the local client user in the primary service.


	get_ReceiveFileDirectory

	Retrieves the local path to the directory currently being used to store any files received
	through file transfer.


	get_UnreadEmailCount

	Retrieves the current number of unread e-mail messages in the Inbox assigned to the 
	currently signed-in client user.


	InstantMessage

	Launches a conversation window with the initial recipient specified as a parameter.

	Parameters:
		<SigninName>


	InviteApp

	Issues an invitation to a user to use a specified application.
	
	Parameteres:
		<SigninName>
		<GUID>
			 The globally unique identifier (GUID) used to register the application that the remote
			 user is being invited to share. This corresponds to the values set in the system 
			 registry during the installation of that application, you must include the curly braces
			 { } on either side.


	MediaWizard

	Launches the Audio and Video Tuning Wizard dialog box.


	OpenInbox

	Launches the default e-mail application and opens the Inbox.


	OptionsPages

	Launches the Options dialog box with a specified tab initially open.

	Parameters:
		[OptionPage]
			 0 - Display the General tab of the Options dialog box (default).
			 1 - Display the Privacy tab of the Options dialog box.
			 2 - Display the Exchange tab of the Options dialog box.
			 3 - Display the Accounts tab of the Options dialog box.
			 4 - Display the Connection tab of the Options dialog box.
			 5 - Display the Preferences tab of the Options dialog box.
			 6 - Display the Services tab of the Options dialog box.
			 7 - Display the Phone tab of the Options dialog.


	Page

	Launches the Page window that is used to page a user, as designated by the input 
	parameter.
	
	Parameters
		<SigninName>


	Phone
	
	Launches the Phone Call dialog box.

	Parameters:
		<SigninName> 
		<Phonetype> 
			0 - Home
			1 - Work
			2 - Mobile
		[PhoneNumber]


	put_MyStatus

	Sets the connection state of the local client user in the primary service.
	
	Parameters:
	  [Status]
		 0 - Online
		 1 - Invisible
		 2 - Busy
		 3 - Be right back
		 4 - Away
		 5 - On the phone
		 6 - Out to lunch


	SendFile

	Launches the Send File mode of a conversation window to a specified contact.

	Parameters
		<SigninName> 
		[FileName]
		
		
	SendMail

	Launches a compose window in the client's default e-mail application with the To: line 
	prepopulated with the sign-in name of the specified contact.
	
	Parameters:
		<SigninName>


	Signin,[SigninName] [Password]

	Launches the Messenger client Sign In dialog box and populates the sign-in name field.

	Parameters:
		[SigninName]
		[Password]

	Signout	

	Signs the current client user out of all Messenger services.


	StartVoice

	Launches a Messenger conversation window to initiate a voice message session with a 
	particular contact, pending acceptance of the invitation. 
	
	Parameters:
		<SigninName>


	ViewProfile

	Launches a new Web browser instance, allowing the client user to view properties of the 
	specified contact through the Public Profiles feature.
	
	Parameters:
		<SigninName>


	CreateGroup

	Creates a new group.
	
	Parameters:
		<Name>


	get_ContactsSortOrder

	Retrieves the contact current sort order for the local client, which is used to determine 
	if the contacts should be sorted by groups or by their online/offline status.


	put_ContactsSortOrder
 
	Sets the contact sort order for the local client, which is used to determine if the 
	contacts should be sorted by groups or by their online/offline status.
	
	Parameters:
	  [Sort]
		 0 - Sorts the local user's contacts by groups.
		 1 - Sorts the local user's contacts by online/offline status.



	StartVideo

	Launches a conversation window to initiate a video session with a particular contact,
	pending acceptance of the invitation. 
	
	Parameters:
		<SigninName>


	get_Blocked

	Retrieves a Boolean value declaring whether the contact associated with this SigninName is
	blocked by the current client user.
	
	Parameters:
		<SigninName>


	get_CanPage	

	Retrieves a Boolean value declaring whether the contact associated with this SigninName 
	has mobile preferences established or visible.


	get_FriendlyName

	Retrieves the friendly name of the contact associated with this SigninName.

	Parameters:
		<SigninName>

	get_IsSelf

	Retrieves a Boolean value declaring whether the contact associated with this SigninName is
	actually the current client user.
	
	Parameters:
		<SigninName>


	get_PhoneNumber

	Retrieves the phone number information for the contact associated with this SigninName. 

	Parameters:
		<SigninName>
		[Phonetype]

	get_ServiceId

	Retrieves the service ID, a globally unique identifier (GUID), for the contact associated
	with this SigninName. 

	Parameters:
		<SigninName>

	get_ServiceName

	Retrieves the service name of the contact associated with this SigninName.

	Parameters:
		<SigninName>
		
	get_Status

	Retrieves the connection status of the contact associated with the SigninName.

	Parameters:
		<SigninName>

	put_Blocked

	Sets a Boolean value declaring whether the contact associated with this SigninName is 
	blocked by the current client user.
	
	Parameters:
		<SigninName>
		[Block]


	get_Count

	Retrieves the number of Contacts/Groups.
	
	Parameters:
		[Contacts|Groups]
		
	Example: 
		//echo -a Total contacts: $dll(msn.dll, get_Count,C) 
		

	Item

	Retrieves a specific SigninName/GroupName by numeric index. 
	
	Parameters:
		[Index] 
		[Contacts|Groups]


	Remove

	Removes a contact.
	
	Parameters:
		<SigninName>
		
	
	put_MyFriendlyName

	Sets the Friendly Name of the local client user.
	
	Parameters:
		<FriendlyName>
		
	put_MyPSM
	
	Sets the personal status message of the local client user.
	
	Parameters:
		<Message>
	
	put_MyDisplayPicture
	
	Sets the Display Picture of the local client user.
	
	Parameters:
		<Path>
		
	
	
Events:

	To handle messenger events you need to create on signal events.

	on *:SIGNAL:msn.event:command
	
	Example:
		on *:SIGNAL:msn.OnSignin: echo Signed in	
		
	
	OnAppShutdown
	Indicates that the client application is about to shut down for purposes of a client upgrade initiated either by the server or client user.

	OnContactAddedToGroup
	Indicates that a contact has been added to a group.

	OnContactBlockChange	
	Indicates that the block settings of a contact in the local client's Contact List have changed. Queries whether the contact is blocked by the local client user.

	OnContactFriendlyNameChange	
	
	Indicates that a contact in the client's Contact List has changed the friendly name.

	OnContactListAdd	
	Indicates the result of an attempt to add to the Messenger object's Contact List.
	
	OnContactListRemove	
	Indicates the result of an attempt to remove a contact from the Messenger object's Contact List.
	
	OnContactPagerChange	
	
	Indicates that a contact in the local client's Contact List has changed the pager information access permissions.
	OnContactPhoneChange	
	
	Indicates that the phone information of a contact in the local client's Contact List has changed.
	
	OnContactPropertyChange	
	Indicates that property information for a contact in the local client's Contact List has changed.
	
	OnContactRemovedFromGroup	
	Indicates that a contact has been removed from a group.
	
	OnContactStatusChange	
	Indicates that the status of a contact in the local client's Contact List has changed, and returns the current state of the contact.

	OnGroupAdded	
	
	Indicates that a new group has been created.
	
	OnGroupNameChanged	
	Indicates that the name of a group has been changed.
	
	OnGroupRemoved	
	Indicates that a group has been deleted.
	
	OnIMWindowContactAdded	
	Indicates that a contact has been added to the ongoing conversation.
	OnIMWindowContactRemoved	
	
	Indicates that a contact has been removed from the ongoing conversation.
	
	OnIMWindowCreated	
	Indicates that a new conversation window has been opened.
	
	OnIMWindowDestroyed	
	Indicates that a new conversation window has been closed.
	
	OnMyFriendlyNameChange	
	Indicates that the local client's friendly name has been changed or that a change was attempted.
	
	OnMyPhoneChange	
	Indicates that the local client's phone contact information has been changed or that a change was attempted.
	
	OnMyPropertyChange	
	Indicates that an uncategorized element of the local client's property information has been changed or that a change was attempted.
	
	OnMyStatusChange	
	Indicates that the status of the local client has changed or that a status change was attempted, and returns the current status of the local client.
	
	OnSignin	
	Indicates that an attempt has been made to sign in to the primary service.
	
	OnSignout	
	Indicates that the local client has signed out of the primary service.
	
	OnUnreadEmailChange	
	Indicates the number of unread e-mail messages in the Messenger client's correlated MSN Hotmail Inbox.