Vp destroy: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
Roy Curtis (talk | contribs)
No edit summary
Line 1: Line 1:
<C>int vp_destroy(VPInstance instance)</C>
{{sdk method page|destroy|Destroys an existing VPInstance.
 
|behavior=If the destroyed instance was connected to a [[world]] and/or a [[universe]], it will be disconnected from both. This is the only way to disconnect a bot from a universe.
== Description ==
|seealso=
Destroys new VP SDK instance.
 
== Callback ==
None
 
== Notes ==
None
 
== Arguments ==
;instance:The SDK instance to destroy.
 
== Argument attributes ==
None
 
== Return values ==
;[[SDK_Reason_Codes#VP_RC_SUCCESS|VP_RC_SUCCESS]]
;[[SDK_Reason_Codes#VP_NO_INSTANCE|VP_NO_INSTANCE]]:Invalid instance passed.
 
== Returned attributes ==
None
 
== Example ==
<C>// ...
int rc;
if(rc = vp_destroy(instance))
    printf("Error destroying VP API (reason %d)\n", rc);</C>
 
== See also ==
* [[vp_connect_universe]]
* [[vp_create]]
* [[vp_create]]
* [[vp_wait]]
}}
 
[[Category: SDK]]

Revision as of 18:51, 28 September 2013

Method call snippet vp_destroy(instance);

Destroys an existing VPInstance.

Parameters

These are the parameters that this method requires:

Parameter Usage
VPInstance
instance
Pointer to the instance this method call is intended for

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)

Behavior

If the destroyed instance was connected to a world and/or a universe, it will be disconnected from both. This is the only way to disconnect a bot from a universe.

Examples

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

See also