Protocols/MSNP/Commands/FND - Revision history

Animadoria at 18:41, 11 May 2022

2022-05-11T18:41:48Z

← Older revision		Revision as of 18:41, 11 May 2022
Line 1:		Line 1:
			{{Protocols/MSNP}}
	= FND =		= FND =
	This command queries the Hotmail member directory and returns matching users.		This command queries the Hotmail member directory and returns matching users.

AD at 13:59, 13 March 2021

2021-03-13T13:59:54Z

@@ Line 102: / Line 102: @@
   <<< FND 3 2 3 fname=William%20Henry lname=Gates city=Seattle state=WA country=US
   <<< FND 3 3 3 fname=William%20Henry lname=Gates city=Redmond state=WA country=US
 [[Category:MSN]]
 [[Category:Protocols/MSNP]]
 [[Category:Work_In_Progress]]

AD: 1 revision imported

2020-05-29T00:23:35Z

1 revision imported

← Older revision		Revision as of 00:23, 29 May 2020
(No difference)

AD at 21:09, 8 February 2010

2010-02-08T21:09:42Z

New page

= FND =
This command queries the Hotmail member directory and returns matching users.

Since (at least) MSNP7 this command is no-longer supported and the server returns error 502. It is included here for historical reasons. The command was first seen in MSNP2 and used up to MSNP4 at the earliest. Its status in MSNP5 through 7 is unknown.

== Sent to Server ==
=== Description ===

>>> FND trId fname=<firstName> lname=<lastName> city=<city> state=<state> country=<country>

=== Parameters ===
Note that parameters are given in key/vale pairs. All parameters except firstName and lastName can be set to the asterisk wildcard, otherwise the server will sent a 201 error. If either the city or state parameters are set (not asterisks) then the country must be US (at the time the member directory did not provide specific geographical information for non-US residents), otherwise the server will disconnect the client.

{| class="wikitable" border="1" style="border: 1px solid darkgray;"
|-
! Name
! Type
! Example Value
! Summary
|-
| trid
| [[Protocols/MSNP/General/Commands#Transaction_IDs|Transaction ID]]
| 1
|
|-
| firstName
| URL-Encoded String
| '''Bill'''
| First name of the person to find. Cannot be asterisk or get 201 error.
|-
| lastName
| URL-Encoded String
| '''Gates'''
| Last name of the person to find. Cannot be asterisk or get 201 error.
|-
| city
| URL-Encoded String
| '''*''' or '''Seattle'''
| City of the person to find, or an asterisk to match any city in the US (set to '''*''' for non-US locations or be disconnected)
|-
| state
| Two-letter US state code
| '''*''' or '''WA'''
| State of the person to find, or an asterisk to match any state in the US (set to '''*''' for non-US locations or be disconnected)
|-
| country
| Two-letter ISO country code
| '''*''' or '''US'''
| Country of the person to find, or an asterisk to match any country.
|-
|}

== Server returns ==
=== Description ===

If too many results:

<<< 301 <trid>

If zero results:

>>> FND <trid> 0 0

If results found:

>>> FND <trid> <idx> <total> fname=<firstName> lname=<lastName> state=<state> country=<country>

The result row is repeated for each user found, with <idx> increasing from 1 to <total>.

=== Parameters ===

{| class="wikitable" border="1" style="border: 1px solid darkgray;"
|-
! Name
! Type
! Example Value
! Summary
|-
| trid
| [[Protocols/MSNP/General/Commands#Transaction_IDs|Transaction ID]]
| 1
| The trid is identical and repeated for each returned result
|-
| idx
| Integer
| 1
| idx starts at 1 and increments for each returned result until it is equal to the total value
|-
| total
| Integer
| 1
| The total number of users returned
|-
|}

The other parameters are self-explanatory and identical to their meaning in the Client-to-server command definition. They are all URL-encoded.

== Example ==

>>> FND 3 fname=William%20Henry lname=Gates city=* state=WA country=US
<<< FND 3 1 3 fname=William%20Henry lname=Gates city=Olympia state=WA country=US
<<< FND 3 2 3 fname=William%20Henry lname=Gates city=Seattle state=WA country=US
<<< FND 3 3 3 fname=William%20Henry lname=Gates city=Redmond state=WA country=US

[[Category:MSN]]
[[Category:Protocols/MSNP]]
[[Category:Work_In_Progress]]