Protocols/OSCAR/SNAC/LOCATE USER INFO QUERY2

OSCAR Protocol

Introduction • Terms • Clients

Basic

Datatypes • FLAP • SNAC • TLV

UUIDs • Errors • Tool IDs

Host Interaction

Rate Limits • Migration • Messages

Other Services

ADMIN • ADVERT • ALERT

BART • BOS • BUCP • CHAT

CHAT_NAV

Tutorials

Sign On • BART • Rendezvous

ICBM • Locate • Buddies

Foodgroups

OSERVICE (0x0001)

LOCATE (0x0002)

BUDDY (0x0003)

ICBM (0x0004)

ADVERT (0x0005)

INVITE (0x0006)

ADMIN (0x0007)

POPUP (0x0008)

PD (0x0009)

USER_LOOKUP (0x000A)

STATS (0x000B)

TRANSLATE (0x000C)

CHAT_NAV (0x000D)

CHAT (0x000E)

ODIR (0x000F)

BART (0x0010)

FEEDBAG (0x0013)

ICQ (0x0015)

BUCP (0x0017)

ALERT (0x0018)

PLUGIN (0x0022)

UNNAMED_FG_24 (0x0024)

MDIR (0x0025)

ARS (0x044A)

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.

SNAC Header

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

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.