| ID
|
Origin
|
Name
|
Foodgroup
|
Service
|
Status
|
Version
|
| 0x0002, 0x0015
|
Client
|
LOCATE__USER_INFO_QUERY2
|
Unspecified
|
BOS
|
Active
|
1.19
|
This SNAC is sent by the client to perform the basic locate query on a user.
| Foodgroup
|
uint16 (word)
|
00 02
|
| Subgroup
|
uint16 (word)
|
00 15
|
| Flags
|
uint16 (word)
|
00 00
|
| Request ID
|
uint32 (dword)
|
00 00 00 00
|
SNAC Data
A client should only use this SNAC when it needs to display information to a user and should not call on every Buddy arrive. Either a LOCATE__USER_INFO_REPLY or a LOCATE__ERR will be generated.
| Name
|
Type
|
Notes
|
| type2
|
uint32 (dword)
|
[Class: LOCATE__QUERY_TYPE] What data should be returned
|
| username
|
string08
|
User for which to the information requested
|
Class: LOCATE__QUERY_TYPE
This class specified which fields the client wants returned when doing a LOCATE__USER_INFO_QUERY2.
| Name
|
Value
|
Notes
|
| LOCATE__TYPE2_SIG
|
0x00000001
|
The AIM signature
|
| LOCATE__TYPE2_UNAVAILABLE
|
0x00000002
|
The away message
|
| LOCATE__TYPE2_CAPABILITIES
|
0x00000004
|
CAPABILITIES UUID array; short caps will be represented in long form
|
| LOCATE__TYPE2_CERTS
|
0x00000008
|
The CERT Blob
|
| LOCATE__TYPE2_HTML_INFO
|
0x00000400
|
Return HTML formatted Buddy Info page
|
From Aleksandr Shutko: SNAC(02,15) LOCATE__USER_INFO_QUERY2
|
Query user online info by screen name. Server should respond with
SNAC(02,06).
Here is the table for request flags bitmask:
| 0x00000001 |
User profile requested (tlv(1)/tlv(2)) |
| 0x00000002 |
User away message requested (tlv(3)/tlv(4)) |
| 0x00000004 |
User capability block requested (tlv(5)) |
| 0x00000008 |
Certification info requested (tlv(1b) ?) |
|
|
| 00 02 |
|
word |
|
SNAC family |
| 00 15 |
|
word |
|
SNAC subtype |
| 00 00 |
|
word |
|
SNAC flags |
| xx xx xx xx |
|
dword |
|
SNAC request-id |
|
| xx xx xx xx |
|
dword |
|
Request flags |
| xx |
|
byte |
|
length of screen name |
| xx .. |
|
string |
|
screen name |
|
|
|
Example SNAC dump with flap header:
2A 02 58 44 00 17 00 02 00 15 00 00 00 04 00 15 *.XD............
00 00 00 01 08 73 6F 6D 65 6E 69 63 6B .....somenick
|
|
LOCATE SNACs
SNAC List
| Subgroup
|
Origin
|
Name
|
| 0x0001
|
Any
|
LOCATE__ERR
|
| This is the error SNAC for the LOCATE foodgroup.
|
| 0x0002
|
Client
|
LOCATE__RIGHTS_QUERY
|
| This query is sent to the server by the client to discover what some of its rights are with respect to the PD SNAC group.
|
| 0x0003
|
Host
|
LOCATE__RIGHTS_REPLY
|
| This is the response to the LOCATE__RIGHTS_QUERY SNAC.
|
| 0x0004
|
Client
|
LOCATE__SET_INFO
|
| The client may set SIG, UNAVAILABLE, and CAPABILITIES type and data tags with this SNAC.
|
| 0x0005
|
Client
|
LOCATE__USER_INFO_QUERY
|
| Request user information for profiles, capabilities, away message, and certificates.
|
| 0x0006
|
Host
|
LOCATE__USER_INFO_REPLY
|
| This is the usual response to a LOCATE__USER_INFO_QUERY2 SNAC.
|
| 0x0007
|
Client
|
LOCATE__WATCHER_SUB_REQUEST
|
| Watcher sub request.
|
| 0x0008
|
Host
|
LOCATE__WATCHER_NOTIFICATION
|
| Watcher sub notification.
|
| 0x0009
|
Client
|
LOCATE__SET_DIR_INFO
|
| Set directory info. Host will reply LOCATE__SET_DIR_REPLY.
|
| 0x000A
|
Host
|
LOCATE__SET_DIR_REPLY
|
| Reply to LOCATE__SET_DIR_INFO.
|
| 0x000B
|
Client
|
LOCATE__GET_DIR_INFO
|
| Get directory information for user. Host should reply with LOCATE__GET_DIR_REPLY.
|
| 0x000C
|
Host
|
LOCATE__GET_DIR_REPLY
|
| Host reply to LOCATE__GET_DIR_INFO.
|
| 0x000D
|
NCD
|
LOCATE__GROUP_CAPABILITY_QUERY
|
| This is not currently documented. Want to contribute?
|
| 0x000E
|
NCD
|
LOCATE__GROUP_CAPABILITY_REPLY
|
| This is not currently documented. Want to contribute?
|
| 0x000F
|
Client
|
LOCATE__SET_KEYWORD_INFO
|
| Set profile keywords and interests. Host should reply with LOCATE__SET_KEYWORD_REPLY.
|
| 0x0010
|
Host
|
LOCATE__SET_KEYWORD_REPLY
|
| This is the host reply to LOCATE__SET_KEYWORD_REPLY.
|
| 0x0011
|
Client
|
LOCATE__GET_KEYWORD_INFO
|
| Set profile keywords and interests. Host should reply with LOCATE__SET_KEYWORD_REPLY.
|
| 0x0012
|
Host
|
LOCATE__GET_KEYWORD_REPLY
|
| This is the host reply to LOCATE__SET_KEYWORD_REPLY.
|
| 0x0013
|
Client
|
LOCATE__FIND_LIST_BY_EMAIL
|
| This is a query sent to the server that looks up a list of users by their email address and returns one NickwInfo for each email account queried.
|
| 0x0014
|
Host
|
LOCATE__FIND_LIST_REPLY
|
| This SNAC provides the results of the LOCATE__FIND_LIST_BY_EMAIL.
|
| 0x0015
|
Client
|
LOCATE__USER_INFO_QUERY2
|
| This SNAC is sent by the client to perform the basic locate query on a user.
|
|