C_FriendList.SendWho

From Warcraft Wiki
Jump to navigation Jump to search
GitHub Octocat.png  Townlong-Yak BAD.png  ProfIcons engineering.png  BTNTemp.png C_FriendList.SendWho TheWarWithin-Icon-Inline.pngDragonflight-Icon-Inline.pngCata-Logo-Small.pngWoW Icon update.png + 8.1.0
Wowprogramming.png  BTNTemp.png SendWho + 1.0.0

Requests a list of other online players.

C_FriendList.SendWho(filter, origin)

Arguments

filter
string - The criteria for which you want to perform a Who query. This can be anything for which you could normally search in a Who query:
  • Any string, which will be matched against players' names, guild names, zones and levels.
  • Name (n-"<char_name>")
  • Zone (z-"<zone_name>")
  • Race (r-"<race_name>")
  • Class (c-"<class_name>")
  • Guild (g-"<guild_name>")
  • Level ranges: (<lower_limit>-<higher_limit>)
These can be combined, but no more than one of each type can be searched for at once. Note that the quotation marks around the zone, race, and class must be present. Double quotation marks are required, as single quotation marks won't work.
origin
Enum.SocialWhoOrigin
Value Field Description
0 Unknown
1 Social
2 Chat
3 Item

Details

  • Fires WHO_LIST_UPDATE when the requested query has been processed. Note that there is a server-side cooldown; queries are not guaranteed to generate a response.

Example

Searches for players in the level 20 to 40 range.

C_FriendList.SendWho("20-40")

Searches for Night Elf Rogues in Teldrassil, of levels 10-15, with the string "bob" in their (guild) names.

C_FriendList.SendWho('bob z-"Teldrassil" r-"Night Elf" c-"Rogue" 10-15')

Patch changes

Dragonflight Patch 10.2.0 (2023-11-07): Added origin argument.
Battle for Azeroth Patch 8.2.5 (2019-09-24): (+ Patch 1.13.2) Requires a hardware event as a measure against gold spam channel invites and other unintended uses for automatically querying player names.
Battle for Azeroth Patch 8.1.0 (2018-12-11): Moved to C_FriendList.SendWho()
WoW Icon update.png Patch 1.0.0 (2004-10-08): Added as SendWho()

See also