Vp object delete: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
Line 1: | Line 1: | ||
{{sdk method page|object_delete|Delete an object. | {{sdk method page|object_delete|Delete an object. | ||
|paramex=object_id | |||
|parameters= | |parameters= | ||
{{sdk parameter row|int|object_id|Id of object to delete}} | |||
|attributes= | |attributes= | ||
|returncodes= | |returncodes= | ||
{{sdk return code row|NOT_IN_WORLD |Bot is not currently in a world}} | {{sdk return code row|NOT_IN_WORLD |Bot is not currently in a world}} |
Revision as of 11:31, 13 December 2016
Method call snippet
vp_object_delete(instance, object_id);
Delete an object.
Parameters
These are the parameters that this method requires:
Parameter | Usage |
---|---|
VPInstance instance |
Pointer to the instance this method call is intended for |
int object_id |
Id of object to delete |
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_WORLD |
Bot is not currently in a world |
The following attributes will be returned in VP_CALLBACK_OBJECT_DELETE
if the operation was successful:
Attribute | Usage | Also returned for |
---|---|---|
VP_OBJECT_ID | Object id of deleted object |
Behavior
- Upon successful deletion of an object,
VP_EVENT_OBJECT_DELETE
is triggered for those who have subscribed to it.
Examples
- This method has no usage examples; please add at least one to this page