Vp friend add by name: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
mNo edit summary
m (Added reference number attribute, reason code)
 
Line 4: Line 4:
   {{sdk parameter row|string|name|Name of user to add}}
   {{sdk parameter row|string|name|Name of user to add}}
|attributes=
|attributes=
  {{sdk attribute row|int|reference_number|Is passed to the callback to identify for which method call it is fired}}
|returncodes=
|returncodes=
  {{sdk return code row|NOT_IN_UNIVERSE|Universe request made while not connected to a universe server}}
|returnattributes=
|returnattributes=
|behavior=
|behavior=

Latest revision as of 23:24, 31 July 2018

Method call snippet vp_friend_add_by_name(instance, name);

Add a user to the friend list.

Parameters

These are the parameters that this method requires:

Parameter Usage
VPInstance
instance
Pointer to the instance this method call is intended for
string
name
Name of user to add

Used attributes

This method uses data set in these attributes when called:

Attribute Usage
VP_REFERENCE_NUMBER Is passed to the callback to identify for which method call it is fired

Returns

This method returns a return code integer, which indicates whether the call was successful or errored for any reason:

Return code Cause
VP_RC_SUCCESS Successful call (for methods that have a registered callback, it only means the request has been sent)
VP_RC_NOT_IN_UNIVERSE Universe request made while not connected to a universe server

Behavior

  • Upon successfully adding a user, VP_EVENT_FRIEND is triggered if the bot has subscribed to it.

Examples

This method has no usage examples; please add at least one to this page

See also