PageRenderTime 36ms CodeModel.GetById 22ms RepoModel.GetById 0ms app.codeStats 0ms

/W3b.MsnpServer/_source/Notes/miscellaneous.php.htm

#
HTML | 441 lines | 310 code | 82 blank | 49 comment | 0 complexity | 57d3f1238ad5192ff1a9c5b56cca5c4a MD5 | raw file
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    2. 

  2. 

  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    4. 

  4. 

  5. <head>
    6. 

  6. 	<title>MSN Messenger Protocol - Notification - Miscellaneous</title>
    7. 

  7. 	<link rel="stylesheet" href="../default.css" type="text/css" />
    8. 

  8. 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    9. 

  9. 	<meta name="description" content="An unofficial overview of the MSN Messenger protocol." />
    10. 

  10. 	<meta name="keywords" content="MSN Messenger Protocol, MSN Messenger, MSN, Protocol, IM, Messenger, Mike Mintz" />
    11. 

  11. 	<meta name="author" content="Mike Mintz (Michael David Mintz)" />
    12. 

  12. </head>
    13. 

  13. 

  14. <body bgcolor="#FFFFFF">
    15. 

  15. 

  16. <br />
    17. 

  17. 

  18. <table cellpadding="0" cellspacing="10" width="100%" border="0" align="center" bgcolor="#FFFFFF">
    19. 

  19. 

  20. <tr valign="top"><td colspan="2">
    21. 

  21. 

  22. <div style="padding: 5pt; margin-left: 10pt; margin-right: 10pt; border-bottom: #AAAAFF solid 1pt" align="right"><font color="#444488"><i>Since March 10, 2003</i> - <b> Version 2</b></font></div>
    23. 

  23. <div style="padding: 5pt; margin-left: 10pt; margin-right: 10pt; border-top: #CCCCFF solid 1pt" align="right"><a href="http://www.hypothetic.org/"><small><b>hypothetic.org</b></small></a></div>
    24. 

  24. 

  25. <h1>MSN Messenger Protocol</h1>
    26. 

  26. 

  27. </td></tr>
    28. 

  28. 

  29. <tr valign="top">
    30. 

  30. 

  31. 	<td>
    32. 

  32. 		<table border="0" cellpadding="0" cellspacing="1" width="200" bgcolor="#FFFFFF">
    33. 

  33. 

  34. 		<tr><td>
    35. 

  35. 			<table border="0" cellpadding="8" cellspacing="5" bgcolor="#000000" width="100%"><tr valign="middle"><td align="center" bgcolor="#FFFFFF">
    36. 

  36. 				<a href="../index.php"><big><b><font style="letter-spacing: 2px">Home Page</font></b></big></a>
    37. 

  37. 			</td></tr></table>
    38. 

  38. 			<br />
    39. 

  39. 		</td></tr>
    40. 

  40. 

  41. 		<tr><td>
    42. 

  42. 			<table border="0" cellpadding="4" cellspacing="3" bgcolor="#CCAAFF" width="100%"><tr valign="middle"><td align="center" bgcolor="#FFFFFF">
    43. 

  43. 				<a href="http://www.hypothetic.org/docs/msn/phorum/"><b><font style="letter-spacing: 1px">Forum</font></b></a>
    44. 

  44. 			</td></tr><tr valign="middle"><td align="center" bgcolor="#FFFFFF">
    45. 

  45. 				<a href="../chat.php"><b><font style="letter-spacing: 1px">Chat</font></b></a>
    46. 

  46. 			</td></tr></table>
    47. 

  47. 			<br />
    48. 

  48. 		</td></tr>
    49. 

  49. 		
    50. 

  50. 		<tr><td>
    51. 

  51. 			<table border="0" cellpadding="4" cellspacing="3" bgcolor="#AACCFF" width="100%"><tr valign="middle"><td align="center" bgcolor="#FFFFFF">
    52. 

  52. 				<a href="../about.php"><b><font style="letter-spacing: 1px">About</font></b></a>
    53. 

  53. 			</td></tr></table>
    54. 

  54. 			<br />
    55. 

  55. 		</td></tr>
    56. 

  56. 				
    57. 

  57. 		<tr><td>
    58. 

  58. 		<table border="0" cellpadding="0" cellspacing="1" width="100%" bgcolor="#000000">
    59. 

  59. 		<tr><td>
    60. 

  60. 			<table border="0" cellpadding="0" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="center" bgcolor="#EEEEEE" height="30">
    61. 

  61. 				<big><b>Resources</b></big>
    62. 

  62. 			</td></tr></table>
    63. 

  63. 		</td></tr>
    64. 

  64. 

  65. 		<tr><td>
    66. 

  66. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#FBFBFB" width="100%"><tr valign="top"><td>
    67. 

  67. 				<div class="menuitem"><b>&middot;</b> <a href="../resources/faq.php">FAQ</a></div>
    68. 

  68. 				<div class="menuitem"><b>&middot;</b> <a href="../resources/unofficial_protocol.php">Unofficial Protocol</a></div>
    69. 

  69. 				<div class="menuitem"><b>&middot;</b> <a href="../resources/projects.php">Projects</a></div>
    70. 

  70. 				<div class="menuitem"><b>&middot;</b> <a href="../resources/links.php">Links</a></div>
    71. 

  71. 			</td></tr></table>
    72. 

  72. 		</td></tr>
    73. 

  73. 

  74. 		</table>
    75. 

  75. 		<br />
    76. 

  76. 		</td></tr>
    77. 

  77. 

  78. 		<tr><td>
    79. 

  79. 		<table border="0" cellpadding="0" cellspacing="1" width="100%" bgcolor="#000000">
    80. 

  80. 		<tr><td>
    81. 

  81. 			<table border="0" cellpadding="0" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="center" bgcolor="#EEEEEE" height="30">
    82. 

  82. 				<big><b>Research</b></big>
    83. 

  83. 			</td></tr></table>
    84. 

  84. 		</td></tr>
    85. 

  85. 

  86. 		<tr><td>
    87. 

  87. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#FBFBFB" width="100%"><tr valign="top"><td>
    88. 

  88. 				<div class="menuitem"><b>&middot;</b> <a href="../research/research_practice.php">Research Practice</a></div>
    89. 

  89. 				<div class="menuitem"><b>&middot;</b> <a href="../research/msnp8.php">MSNP8</a></div>
    90. 

  90. 				<div class="menuitem"><b>&middot;</b> <a href="../research/msnp9.php">MSNP9</a></div>
    91. 

  91. 				<div class="menuitem"><b>&middot;</b> <a href="../research/msnp10.php">MSNP10</a></div>
    92. 

  92. 				<div class="menuitem"><b>&middot;</b> <a href="../research/client_ID.php">Client ID structure</a></div>
    93. 

  93. 			</td></tr></table>
    94. 

  94. 		</td></tr>
    95. 

  95. 

  96. 		</table>
    97. 

  97. 		<br />
    98. 

  98. 		</td></tr>
    99. 

  99. 

  100. 		<tr><td>
    101. 

  101. 		<table border="0" cellpadding="0" cellspacing="1" width="100%" bgcolor="#000000">
    102. 

  102. 

  103. 		<tr><td>
    104. 

  104. 			<table border="0" cellpadding="0" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="center" bgcolor="#EEEEEE" height="30">
    105. 

  105. 				<big><b>Documentation</b></big>
    106. 

  106. 			</td></tr></table>
    107. 

  107. 		</td></tr>
    108. 

  108. 

  109. 		<tr><td>
    110. 

  110. 			<table border="0" cellpadding="1" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="left" bgcolor="#FFFAEF" height="20">
    111. 

  111. 				&nbsp;<b>General</b>
    112. 

  112. 			</td></tr></table>
    113. 

  113. 		</td></tr>
    114. 

  114. 

  115. 		<tr><td>
    116. 

  116. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#FFFDF8" width="100%"><tr valign="top"><td>
    117. 

  117. 				<div class="menuitem"><b>&middot;</b> <a href="../general/overview.php">Overview</a></div>
    118. 

  118. 				<div class="menuitem"><b>&middot;</b> <a href="../general/glossary.php">Glossary</a></div>
    119. 

  119. 				<div class="menuitem"><b>&middot;</b> <a href="../general/connections.php">Connections</a></div>
    120. 

  120. 				<div class="menuitem"><b>&middot;</b> <a href="../general/http_connections.php">HTTP Connections</a></div>
    121. 

  121. 				<div class="menuitem"><b>&middot;</b> <a href="../general/commands.php">Commands</a></div>
    122. 

  122. 				<div class="menuitem"><b>&middot;</b> <a href="../general/payload_commands.php">Payload Commands</a></div>
    123. 

  123. 				<div class="menuitem"><b>&middot;</b> <a href="../general/names.php">Names</a></div>
    124. 

  124. 				<div class="menuitem"><b>&middot;</b> <a href="../general/md5.php">MD5</a></div>
    125. 

  125. 			</td></tr></table>
    126. 

  126. 		</td></tr>
    127. 

  127. 

  128. 

  129. 		<tr><td>
    130. 

  130. 			<table border="0" cellpadding="1" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="left" bgcolor="#EFFFEF" height="20">
    131. 

  131. 				&nbsp;<b>Notification</b>
    132. 

  132. 			</td></tr></table>
    133. 

  133. 		</td></tr>
    134. 

  134. 

  135. 		<tr><td>
    136. 

  136. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#F8FFF8" width="100%"><tr valign="top"><td>
    137. 

  137. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/authentication.php">Authentication</a></div>
    138. 

  138. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/statuses.php">Statuses</a></div>
    139. 

  139. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/pings_challenges.php">Pings / Challenges</a></div>
    140. 

  140. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/contact_lists.php">Contact Lists</a></div>
    141. 

  141. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/users_groups.php">Users / Groups</a></div>
    142. 

  142. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/messages.php">Messages</a></div>
    143. 

  143. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/miscellaneous.php">Miscellaneous</a></div>
    144. 

  144. 				<div class="menuitem"><b>&middot;</b> <a href="../notification/example_session.php">Example Session</a></div>
    145. 

  145. 			</td></tr></table>
    146. 

  146. 		</td></tr>
    147. 

  147. 		
    148. 

  148. 		<tr><td>
    149. 

  149. 			<table border="0" cellpadding="1" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="left" bgcolor="#FFEFEF" height="20">
    150. 

  150. 				&nbsp;<b>Switchboard</b>
    151. 

  151. 			</td></tr></table>
    152. 

  152. 		</td></tr>
    153. 

  153. 

  154. 		<tr><td>
    155. 

  155. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#FFF8F8" width="100%"><tr valign="top"><td>
    156. 

  156. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/authentication.php">Authentication</a></div>
    157. 

  157. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/participants.php">Participants</a></div>
    158. 

  158. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/messages.php">Messages</a></div>
    159. 

  159. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/plaintext.php">Plaintext</a></div>
    160. 

  160. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/invitations.php">Invitations</a></div>
    161. 

  161. 				<div class="menuitem"><b>&middot;</b> <a href="../switchboard/example_session.php">Example Session</a></div>
    162. 

  162. 			</td></tr></table>
    163. 

  163. 		</td></tr>
    164. 

  164. 		
    165. 

  165. 		<tr><td>
    166. 

  166. 			<table border="0" cellpadding="1" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="left" bgcolor="#FAEFFF" height="20">
    167. 

  167. 				&nbsp;<b>Protocols</b>
    168. 

  168. 			</td></tr></table>
    169. 

  169. 		</td></tr>
    170. 

  170. 

  171. 		<tr><td>
    172. 

  172. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#FCF8FF" width="100%"><tr valign="top"><td>
    173. 

  173. 				<div class="menuitem"><b>&middot;</b> <a href="../protocols/invitations.php">Invitations</a></div>
    174. 

  174. 				<div class="menuitem"><b>&middot;</b> <a href="../protocols/file_transfer.php">File Transfer</a></div>
    175. 

  175. 			</td></tr></table>
    176. 

  176. 		</td></tr>
    177. 

  177. 				
    178. 

  178. 		<tr><td>
    179. 

  179. 			<table border="0" cellpadding="1" cellspacing="1" bgcolor="#000000" width="100%"><tr valign="middle"><td align="left" bgcolor="#EFFAFF" height="20">
    180. 

  180. 				&nbsp;<b>Reference</b>
    181. 

  181. 			</td></tr></table>
    182. 

  182. 		</td></tr>
    183. 

  183. 

  184. 		<tr><td>
    185. 

  185. 			<table border="0" cellpadding="2" cellspacing="0" bgcolor="#F8FCFF" width="100%"><tr valign="top"><td>
    186. 

  186. 				<div class="menuitem"><b>&middot;</b> <a href="../reference/original_draft.php">Original Draft</a></div>
    187. 

  187. 				<div class="menuitem"><b>&middot;</b> <a href="../reference/error_list.php">Error List</a></div>
    188. 

  188. 			</td></tr></table>
    189. 

  189. 		</td></tr>
    190. 

  190. 

  191. 		</table>
    192. 

  192. 		
    193. 

  193. 		</td></tr>
    194. 

  194. 		
    195. 

  195. 		<tr><td align="center">
    196. 

  196. 			<br />
    197. 

  197. 			<!--<a href="http://validator.w3.org/check/referer"><small>Validate XHTML</small></a>-->
    198. 

  198. 			<a href="http://validator.w3.org/check?uri="><small>Validate XHTML</small></a>
    199. 

  199. 			<br />
    200. 

  200. 			<!--<a href="http://jigsaw.w3.org/css-validator/check/referer"><small>Validate CSS</small></a>-->
    201. 

  201. 			<a href="http://jigsaw.w3.org/css-validator/validator?uri="><small>Validate CSS</small></a>
    202. 

  202. 			<br />
    203. 

  203. 	  	</td></tr>
    204. 

  204. 		
    205. 

  205. 		</table>
    206. 

  206. 

  207. 	</td>
    208. 

  208. 

  209. 	<td width="100%">
    210. 

  210. 

  211. <table border="0" cellpadding="3" cellspacing="0" bgcolor="#AAAAAA" width="100%"><tr valign="middle">
    212. 

  212. <td align="center" bgcolor="#FFFFFF" width="100%">
    213. 

  213. 	<font color="#663399" style="letter-spacing: 2px" size="+2"><b>Notification - Miscellaneous</b></font>
    214. 

  214. </td>
    215. 

  215. <td align="center" bgcolor="#EEEEEE">
    216. 

  216. <div><b>Printable&nbsp;Version</b></div>
    217. 

  217. <div><a href="/docs/msn/sitev2.0/notification/miscellaneous.php?printable=color">Color</a> / <a href="/docs/msn/sitev2.0/notification/miscellaneous.php?printable=gray">Grayscale</a></div>
    218. 

  218. </td>
    219. 

  219. </tr></table>
    220. 

  220. 

  221. <h2>Cosnumer Versioning (CVR)<a name="cvr"></a></h2>
    222. 

  222. 

  223. 	<p>The <code>CVR</code> command sends version information about a client and operating system to the server. For the official client, the server will reply with information about a recommended version of the client (which may be the same as the current version).</p>
    224. 

  224. 	<p>The <code>CVR</code> command is optional in protocol versions up to and including MSNP7. It's debatable whether third-party clients should send <code>CVR</code>. On one hand, Microsoft might start blocking users based on this command. On the other hand, they might treat third-party clients better if there was evidence that a significant number of people used them. On the one hand, there are serious privacy issues with the information given out. On the other hand, there's no way for Microsoft to verify the information given.</p>
    225. 

  225. 	<p>The <code>CVR</code> command includes information about the language you speak, the name and version of your client, and the name and version of your OS. You can send a <code>CVR</code> command to the NS at any time after you have finished logging in, but the official client always sends it immediately after sending the initial <code>CHG</code>. You can send <code>CVR</code> as many or as few times as you like. <code>CVR</code> has a TrID and 6 parameters in MSNP2 and MSNP3, or 7 parameters in MSNP5 and MSNP7.</p>
    226. 

  226. 

  227. <ul>
    228. 

  228. 	<li>The first parameter is hexadecimal number specifying your <a href="http://krafft.com/scripts/deluxe-calendar/lcid_chart.htm">locale ID</a> (e.g. "0x0409" For U.S. English).</li>
    229. 

  229. 	<li>The second parameter is your OS type (e.g. "win" for Windows).</li>
    230. 

  230. 	<li>The third parameter is your OS version (e.g. "4.10" for Windows 98).</li>
    231. 

  231. 	<li>The fourth parameter is the architecture of your computer (e.g. "i386" for Intel-comaptible PCs of type 386 or above).</li>
    232. 

  232. 	<li>The fifth parameter is your client name (e.g. "MSMSGS" for the official MSN Messenger client).</li>
    233. 

  233. 	<li>The sixth parameter is your client version (e.g. "1.0.0863" for the first version of the official client).</li>
    234. 

  234. 	<li>The seventh parameter is always "MSMSGS" in the official client. Your guess about what this means is as good as mine.</li>
    235. 

  235. </ul>
    236. 

  236. 

  237. <p>Like with any other command, the server will reply to a <code>CVR</code> command with a <code>CVR</code> reply. For some reason, though, the official client would be just as happy if you replaced <code>CVR</code> with <code>CVQ</code> in the reply. The reply command will contain 5 parameters:</p>
    238. 

  238. 

  239. 	<ul>
    240. 

  240. 		<li>The first parameter is a recommended version of the client for you to use, or "1.0.0000" if your client information is not recognised.</li>
    241. 

  241. 		<li>The second parameter is identical to the first.</li>
    242. 

  242. 		<li>The third parameter is "1.0.0000".</li>
    243. 

  243. 		<li>The fourth parameter is a URL you can download the recommended version of the client from.</li>
    244. 

  244. 		<li>The fifth parameter is a URL the user can go to to get more information about the client.</li>
    245. 

  245. 	</ul>
    246. 

  246. 

  247. 	<p>Here is the <code>CVR</code> information sent by version 3.6 of the official client.</p>
    248. 

  248. 

  249. 	<p><code class="client">&gt;&gt;&gt; CVR 7 0x0409 win 4.10 i386 MSMSGS 3.6.0025 MSMSGS<code class="newline">\r\n</code></code></p>
    250. 

  250. 	<p><code class="server">&lt;&lt;&lt; CVR 7 4.6.0083 4.6.0083 1.0.0000 http://download.microsoft.com&#x200B;/download/msnmessenger/install/4.6/win98me/en-us/&#x200B;mmssetup.exe http://messenger.microsoft.com<code class="newline">\r\n</code></code></p>
    251. 

  251. 	<p><code class="client">&gt;&gt;&gt; CVR 8 0x0409 win 4.10 i386 MSGSTRST 3.6.0025 MSMSGS<code class="newline">\r\n</code></code></p>
    252. 

  252. 	<p><code class="server">&lt;&lt;&lt; CVR 8 1.0.0000 1.0.0000 1.0.0000 http://download.microsoft.com&#x200B;/download/msnmessenger/install/4.6/win98me/en-us/&#x200B;mmssetup.exe http://messenger.microsoft.com.<code class="newline">\r\n</code></code></p>
    253. 

  253. 

  254. 

  255. <h2>Service URLs (URL)<a name="url"></a></h2>
    256. 

  256. 	<p>The <code>URL</code> command retrieves URLs relating to the various MSN services to be opened in an external or integrated browser. It takes one parameter, which can be multiple words. Note that the parameter is case-sensitive. The <code>0x...</code> does not symbolize a special character and is to be taken literally. The parameter must be one of the following:</p>
    257. 

  257. 	<ul>
    258. 

  258. 		<li><code>INBOX</code> - Hotmail inbox</li>
    259. 

  259. 		<li><code>FOLDERS</code> - Believed to be the Hotmail's "MSN home" URL.</li>
    260. 

  260. 		<li><code>COMPOSE</code> - Compose an email</li>
    261. 

  261. 		<li><code>COMPOSE example@passport.com</code> - Compose an email for example@passport.com</li>
    262. 

  262. 		<li><code>PROFILE 0x1409</code> - Edit your MSN member directory profile</li>
    263. 

  263. 		<li><code>CHGMOB</code> - Mobile settings (pager etc.)</li>
    264. 

  264. 		<li><code>PERSON 0x0409</code> - Member services, password, secret question, account info</li>
    265. 

  265. 		<li><code>CHAT 0x0409</code> - Chat rooms</li>
    266. 

  266. 	</ul>
    267. 

  267. 	<p>The server will respond with another <code>URL</code>. It always has three parameters: the first two are URLs and the third is an ID number. These parameters are used to determine how to direct the web browser. The first four items are explained in the <a href="../notification/messages.php#hotmail_login">notification server messages page</a>.</p>
    268. 

  268. 	<p>Below is an example of requesting the URL information for the Hotmail inbox:</p>
    269. 

  269. 	<p><code class="server">&gt;&gt;&gt; URL 15 INBOX<code class="newline">\r\n</code></code></p>
    270. 

  270. 	<p><code class="client">&lt;&lt;&lt; URL 15 /cgi-bin/HoTMaiL https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 2<code class="newline">\r\n</code></code></p>
    271. 

  271. 	<p>The <code>URL</code> command does not give you the URL to view profiles of people in the <a href="http://members.msn.com">MSN Member List</a>. To do this, direct the web browser to <code>http://members.msn.com/default.msnw?mem=<font color="#AA00AA">ACCOUNTNAME</font></code> where <code><font color="#AA00AA">ACCOUNTNAME</font></code> is the account name of the user whose profile you want to view.</p>
    272. 

  272. 

  273. <h2>Sending an e-mail invitation</h2>
    274. 

  274. 

  275. 	<p><b>Note: This command has not been well tested. If you have done any research on this command, please <a href="../about.php#contact">let us know</a>!</b></p>
    276. 

  276. 

  277. 	<p>You can send an e-mail saying <i>"&lt;your-passport&gt; wants to talk to you!"</i> to a specified e-mail address with the <code>SND</code> command, which has a TrID and 4 parameters.</p>
    278. 

  278. 

  279. 	<ul>
    280. 

  280. 		<li>The first parameter is the e-mail address you want to send the message to.</li>
    281. 

  281. 		<li>The second parameter is the <a href="http://krafft.com/scripts/deluxe-calendar/lcid_chart.htm">locale ID</a> of the language to send the message in.</li>
    282. 

  282. 		<li>The third and fourth parameters are "MSMSGS MSMSGS".</li>
    283. 

  283. 	</ul>
    284. 

  284. 

  285. 	<p>If the message was sent successfully, the server will reply with an <code>SND</code> with a single parameter of <code>OK</code>. Here is an example.</p>
    286. 

  286. 

  287. 	<p><code class="client">&gt;&gt;&gt; SND 22 alice@hotmail.com 0x409 MSMSGS MSMSGS<code class="newline">\r\n</code></code></p>
    288. 

  288. 	<p><code class="server">&lt;&lt;&lt; SND 22 OK<code class="newline">\r\n</code></code></p>
    289. 

  289. 

  290. 	<p>If bob@hotmail.com sent this message, Alice would receive an e-mail saying <i>"bob@hotmail.com wants to talk to you!"</i>.</p>
    291. 

  291. 

  292. <h2>Searching For Users<a name="fnd"></a></h2>
    293. 

  293. 

  294. 	<p>MSN Messenger used to include a search facility, but this has been superceded by the <a href="http://members.msn.com/">MSN Memeber Directory</a>.  The command used for this was <code>FND</code>.  Sending an <code>FND</code> command in any version of the MSN Messenger protocol will now cause you to receive a <code>502</code> error, and nothing more.</p>
    295. 

  295. 

  296. <!--
    297. 

  297. 	<p>You can try to find people on MSN with the <code>FND</code> command, though this has been largely superceded by the <a href="http://members.msn.com/">MSN Memeber Directory</a> in recent years. <code>FND</code> has a TrID and five parameters. For some reason, all of the parameters to FND have a "key=value" format, for example "fname=Mike" or "lname=Mintz".</p>
    298. 

  298. 

  299. 	<ul>
    300. 

  300. 		<li>The first parameter is "fname=&lt;First name&gt;". If you set the value of fname to <code>*</code>, the server will return error <code>201</code>.</li>
    301. 

  301. 		<li>The second parameter is "lname=&lt;Last name&gt;". If you set the value of lname to <code>*</code>, the server will return error <code>201</code>.</li>
    302. 

  302. 		<li>The third parameter is "city=&lt;City&gt;". Only major US cities are allowed.</li>
    303. 

  303. 		<li>The fourth parameter is "state=&lt;U.S. state&gt;". This is a two-letter code for a US state.</li>
    304. 

  304. 		<li>The fifth parameter is "country=&lt;Country&gt;". This is the two letter <a href="http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/index.html">ISO country code</a>.</li>
    305. 

  305. 	</ul>
    306. 

  306. 

  307. 	<p><code>city</code>, <code>state</code>, or <code>country</code> can be set to <code>*</code>, meaning "any". If you specify a country other than "US", you must set city and state to <code>*</code>, or you will be disconnected.</p>
    308. 

  308. 	<p>There is an (as yet unknown) maximum number of matches allowed on a query. If a search has more than the maximum number of matches, the server will return error <code>301</code>. Otherwise, it will return a series of matches, one per command. The matches have 6 arguments: an incrementing number, a total number, first name, last name, city, state, and country of an individual match. Here are some examples.</p>
    309. 

  309. 

  310. 	<p><code class="client">&gt;&gt;&gt; FND 3 fname=Bill lname=Gates city=* state=* country=US<code class="newline">\r\n</code></code></p>
    311. 

  311. 	<p><code class="server">&lt;&lt;&lt; 301 3<code class="newline">\r\n</code></code></p>
    312. 

  312. 

  313. 	<p><code class="client">&gt;&gt;&gt; FND 3 fname=Mike lname=Mintz city=* state=* country=DE<code class="newline">\r\n</code></code></p>
    314. 

  314. 	<p><code class="server">&lt;&lt;&lt; FND 3 0 0<code class="newline">\r\n</code></code></p>
    315. 

  315. 

  316. 	<p><code class="client">&gt;&gt;&gt; FND 9 fname=Mike lname=Mintz city=* state=* Country=US<code class="newline">\r\n</code></code></p>
    317. 

  317. 	<p><code class="server">
    318. 

  318. 		&lt;&lt;&lt; FND 9 1 3 fname=Mike lname=Mintz State=Alaska Country=US<code class="newline">\r\n</code><br />
    319. 

  319. 		&nbsp;&nbsp;&nbsp; FND 9 2 3 fname=Mike lname=Mintz State=South%20Dakota Country=US<code class="newline">\r\n</code><br />
    320. 

  320. 		&nbsp;&nbsp;&nbsp; FND 9 3 3 fname=Mike lname=Mintz State=Oklahoma Country=US<code class="newline">\r\n</code>
    321. 

  321. 	</code></p>
    322. 

  322. 

  323. <h3>SDC</h3>
    324. 

  324. 

  325. 	<p><b>Note: This command has not been well tested. If you have done any research on this command, please <a href="../about.php#contact">let us know</a>!</b></p>
    326. 

  326. 

  327. 	<p>After finding someone with <code>FND</code>, you can use the <code>SDC</code> command much like <code>SND</code>, above. The user specified with <code>SDC</code> will receive an e-mail saying <i>"&lt;your_friendlyname&gt; wants to talk to you!"</i>. <code>SDC</code> has a TrID and 8 parameters.</p>
    328. 

  328. 	<ul>
    329. 

  329. 		<li>The first parameter is the the incrementing number associated with the match.</li>
    330. 

  330. 		<li>The second, third, fourth, fifth and sixth parameters are "0x0409 MSMSGS WindowsMessenger X X"</li>
    331. 

  331. 		<li>The seventh argument is the friendly name you want to specify in the e-mail address they receive.</li>
    332. 

  332. 		<li>The eighth argument is the length of the payload to this command.</li>
    333. 

  333. 	</ul>
    334. 

  334. 

  335. 	<p>For example, if I had just run the above search for Mike Mintz, and decided to contact the Mike Mintz in Alaska, I might send the following:</p>
    336. 

  336. 

  337. 	<p><code class="client">
    338. 

  338. 		&gt;&gt;&gt; SDC 3 1 0x0409 MSMSGS WindowsMessenger X X Andrew%20Sayers 8<code class="newline">\r\n</code><br />
    339. 

  339. 		&nbsp;&nbsp;&nbsp; Hi Mike! <code class="other">(no newline)</code>
    340. 

  340. 	</code></p>
    341. 

  341. 

  342. 	<!-- * What do you receive when you send an SDC? -->
    343. 

  343. 

  344. <h2>MSN Alerts<a name="not"></a></h2>
    345. 

  345. 

  346. 	<p><b>Note: This command has not been well tested. If you have done any research on this command, please <a href="../about.php#contact">let us know</a>!</b></p>
    347. 

  347. 

  348. 	<p>MSN Alerts use the <code>NOT</code> ("notification") command, which has one parameter - the length of the message body.</p>
    349. 

  349. 	<p>If you use the official client, you can register this service by clicking on the golden bell tab (under the msn "green buddy" tab).</p>
    350. 

  350. 	<p>This command hasn't been thoroughly researched, so the information in this section is fairly speculative. If you are interested in it, please <a href="../about.php#contact">let us know</a> what you find! Only two examples of this command has been observed.</p>
    351. 

    352. 

  352. 	<p><code class="server">
    353. 

  353. 		&lt;&lt;&lt; NOT 586<code class="newline">\r\n</code><br />
    354. 

  354. 		&nbsp;&nbsp;&nbsp; &lt;NOTIFICATION ver="1" siteid="111100200" siteurl="http://calendar.msn.com" id="2"&gt;<code class="newline">\r\n</code><br />
    355. 

  355. 		&nbsp;&nbsp;&nbsp; &lt;TO pid="0x00060000:0x81ee5a43" name="jabber_test@hotmail.com" /&gt;<code class="newline">\r\n</code><br />
    356. 

  356. 		&nbsp;&nbsp;&nbsp; &lt;MSG pri="" id="2"&gt;<code class="newline">\r\n</code><br />
    357. 

  357. 		&nbsp;&nbsp;&nbsp; &lt;ACTION url=&#x200B;"/calendar/isapi.dll?request=action&amp;operation=modify&#x200B;&amp;objectID=2&#x200B;&amp;uicode1=modifyreminder&amp;locale=2052"/&gt;<code class="newline">\r\n</code><br />
    358. 

  358. 		&nbsp;&nbsp;&nbsp; &lt;SUBSCR url=&#x200B;"/calendar/isapi.dll?request=action&amp;operation=modify&#x200B;&amp;objectID=2&#x200B;&amp;uicode1=modifyreminder&amp;locale=2052"/&gt;&#x200B;&lt;CAT id="111100201" /&gt;<code class="newline">\r\n</code><br />
    359. 

  359. 		&nbsp;&nbsp;&nbsp; &lt;BODY lang="2052" icon="/En/img/calendar.png"&gt;<code class="newline">\r\n</code><br />
    360. 

  360. 		&nbsp;&nbsp;&nbsp; &lt;TEXT&gt;aaaaa (bbbbb) 2002偁十䁁月14�星期�21:45 - 22:45 &lt;/TEXT&gt;<code class="newline">\r\n</code><br />
    361. 

  361. 		&nbsp;&nbsp;&nbsp; &lt;/BODY&gt;<code class="newline">\r\n</code><br />
    362. 

  362. 		&nbsp;&nbsp;&nbsp; &lt;/MSG&gt;<code class="newline">\r\n</code><br />
    363. 

  363. 		&nbsp;&nbsp;&nbsp; &lt;/NOTIFICATION&gt;<code class="newline">\r\n</code><br />
    364. 

  364. 	</code></p>
    365. 

  365. 

  366. 	<p><code class="server">
    367. 

  367. 		&lt;&lt;&lt; NOT 590<code class="newline">\r\n</code><br />
    368. 

  368. 		&nbsp;&nbsp;&nbsp; &lt;NOTIFICATION ver="1" siteid="111100200" siteurl="http://calendar.msn.com" id="1"&gt;<code class="newline">\r\n</code><br />
    369. 

  369. 		&nbsp;&nbsp;&nbsp; &lt;TO pid="0x00060000:0x81ee5a43" name="jabber_test@hotmail.com" /&gt;<code class="newline">\r\n</code><br />
    370. 

  370. 		&nbsp;&nbsp;&nbsp; &lt;MSG pri="" id="1"&gt;<code class="newline">\r\n</code><br />
    371. 

  371. 		&nbsp;&nbsp;&nbsp; &lt;ACTION url=&#x200B;"/calendar/isapi.dll?request=action&amp;operation=modify&#x200B;&amp;objectID=1&#x200B;&amp;uicode1=modifyreminder&amp;locale=2052"/&gt;<code class="newline">\r\n</code><br />
    372. 

  372. 		&nbsp;&nbsp;&nbsp; &lt;SUBSCR url=&#x200B;"/calendar/isapi.dll?request=action&amp;operation=modify&#x200B;&amp;objectID=1&#x200B;&amp;uicode1=modifyreminder&amp;locale=2052"/&gt;&#x200B;&lt;CAT id="111100201" /&gt;<code class="newline">\r\n</code><br />
    373. 

  373. 		&nbsp;&nbsp;&nbsp; &lt;BODY lang="2052" icon="/En/img/calendar.png"&gt;<code class="newline">\r\n</code><br />
    374. 

  374. 		&nbsp;&nbsp;&nbsp; &lt;TEXT&gt;goto club 7. 2002 21:15 - 22:15 &lt;/TEXT&gt;<code class="newline">\r\n</code><br />
    375. 

  375. 		&nbsp;&nbsp;&nbsp; &lt;/BODY&gt;<code class="newline">\r\n</code><br />
    376. 

  376. 		&nbsp;&nbsp;&nbsp; &lt;/MSG&gt;<code class="newline">\r\n</code><br />
    377. 

  377. 		&nbsp;&nbsp;&nbsp; &lt;/NOTIFICATION&gt;<code class="newline">\r\n</code><br />
    378. 

  378. 	</code></p>
    379. 

  379. 

  380. 	<p>The body appears to be XML, though we're not sure whether it's actually parsed as XML, which commands are necessary, whether you can insert arbitrary extra fields, and so on. Our current theories about the various sections of the message are:</p>
    381. 

  381. 

  382. 	<ul>
    383. 

  383. 	<li>The NOTIFICATION element specifies that this is a notification.
    384. 

  384. 		<ul>
    385. 

  385. 		<li>The "ver" attribute specifies the version of the notification standard being used.</li>
    386. 

  386. 		<li>The "siteurl" attribute is the base URL to be used with the relative URLs in nested elements.</li>
    387. 

  387. 		<li>The "id" attribute is an ID value which increases by one for every notification in the current session.</li>
    388. 

  388. 		</ul>
    389. 

  389. 	</li>
    390. 

  390. 	<li>The TO element specifies who the message is addressed to (i.e. you). The "name" attribute is your passport.</li>
    391. 

  391. 	<li>The MSG element contains a particular message. This might suggest that more (or less?) than one message can be sent in a single notification. The "id" attribute is the same as the id of the NOTIFICATION tag.</li>
    392. 

  392. 	<li>The ACTION and SUBSCR elements are identical, and give a URL (relative to the URL given in the NOTIFICATION element) to visit.</li>
    393. 

  393. 	<li>The CAT element might be some kind of categorisation?</li>
    394. 

  394. 	<li>The BODY element contains the body of the notification.
    395. 

  395. 		<ul>
    396. 

  396. 		<li>The "lang" attribute is a language code.</li>
    397. 

  397. 		<li>The "icon" attribute is an icon to display in the alert box.</li>
    398. 

  398. 		</ul>
    399. 

  399. 	</li>
    400. 

  400. 	<li>The TEXT element contains the text of the alert</li>
    401. 

  401. 	</ul>
    402. 

  402. 

  403. <h2>Mobile Paging (PAG)<a name="pag"></a></h2>
    404. 

  404. 

  405. 	<p><b>Note: This command has not been well tested. If you have done any research on this command, please <a href="../about.php#contact">let us know</a>!</b></p>
    406. 

  406. 

  407. 	<p>You can page someone on their <a href="http://mobile.msn.com">MSN Mobile</a> device with the <code>PAG</code> command. It is believed that you can receive an incoming message from an MSN Mobile device with the <code>IPG</code> command.</p>
    408. 

  408. 

  409. 	<p>If someone on your forward list has an MSN Mobile device and have allowed you to send messages to them with it, their "MOB" will be set to "Y". The <code>PAG</code> command has a TrID and two arguments.</p>
    410. 

  410. 

  411. 	<ul>
    412. 

  412. 		<li>The first argument is the passport of the user you want to send the message to.</li>
    413. 

  413. 		<li>The second argument is the length of the message body.</li>
    414. 

  414. 	</ul>
    415. 

  415. 

  416. 	<p>The body of a PAG can be either <code>&lt;TEXT xml:space="preserve"&gt; . . . &lt;/TEXT&gt;</code> or <code>&lt;PHONE pri="1"&gt;&#x200B;&lt;LOC&gt;string&lt;/LOC&gt;&#x200B;&lt;NUM&gt;string&lt;/NUM&gt;&#x200B;&lt;/PHONE&gt;&lt;&#x200B;TEXT xml:space="preserve"&gt; . . . &lt;/TEXT&gt;</code>. The extra information in the second format is not yet understood.</p>
    417. 

  417. 	<p>If the command failed to send, the reply is an <code>800</code> error. If there is some other error (for example, you are not allowed to send <code>PAG</code>s, or your <code>PAG</code> is malformed), you get a 220 error. If the message was sent successfully, there is no reply.</p>
    418. 

  418. 	<p>A message sent with the PAG command must be no more than 113 characters long. It can include any characters valid in an XML document. That means that <code>&amp;</code> must be converted to <code>&amp;amp;</code>, characters with values greater than 127 or less than 32 must be converted to <code>&amp;#NN;</code>, etc.</p>
    419. 

  419. 

  420. 	<p>The <code>IPG</code> command has never been observed in the wild, but analysis of the official client suggests that it is a normal payload command with a specified length.</p>
    421. 

  421. 

  422. 

  423. </td>
    424. 

  424. 

  425. </tr>
    426. 

  426. 

  427. </table>
    428. 

  428. 

  429. <h1> </h1>
    430. 

  430. 

  431. <div align="center">
    432. 

  432. <small>
    433. 

  433. Copyright &copy;2002-2003 to <a href="http://www.mikemintz.com/">Mike Mintz</a>.
    434. 

  434. </small>
    435. 

  435. </div>
    436. 

  436. 

  437. <br />
    438. 

  438. 

  439. </body>
    440. 

  440. 

  441. </html>
    442.