API BNGetFriendInfoByID

Returns information about the specified RealID friend presenceID, givenName, surname, toonName, toonID, client, isOnline, lastOnline, isAFK, isDND, broadcastText, noteText, isFriend, broadcastTime = BNGetFriendInfoByID(presenceID)

Arguments

 * presenceID: number - a unique numeric identifier for this friend for the current session

Returns

 * presenceID, givenName, surname, toonName, toonID, client, isOnline, lastOnline, isAFK, isDND, broadcastText, noteText, isFriend, broadcastTime


 * presenceID : Number - a unique numeric identifier for this friend for this session
 * givenName : String - a |K Escape Sequence representing the friend's first/given name (As of 4.0)
 * surname : String - a |K Escape Sequence representing the friend's Surname/family name (As of 4.0)
 * toonName : String - the name of the friend's currently logged in character
 * toonID : Number - a unique numeric identifier for this friend's character for this session
 * client : String - Either "WoW" or "S2", for World of Warcraft or Starcraft2
 * isOnline : Boolean - true if the friend is online
 * lastOnline : Number - the number of seconds since this friend was last online since last Epoch, January 1, 1970, nil if currently online
 * isAFK : Boolean - true if the friend is flagged as Away
 * isDND : Boolean - true if the friend is flagged as Busy
 * broadcastText : String - the contents of the friend's broadcast message
 * noteText : String - the contents of the player's note about this friend
 * isFriend : Boolean - unknown
 * broadcastTime : Number - the number of seconds since the friend send the current broadcast

Details
The client names can be accessed via the globals BNET_CLIENT_WOW and BNET_CLIENT_SC2 Even though the presenceID was passed as an argument, it's still the first item to be returned