vp_connect_universe
Method call snippet
vp_connect_universe(instance, "universe.virtualparadise.org", 57000);
Connects an instance to a universe server. Required before an instance log in with user credentials and connects to any world.
Parameters
These are the parameters that this method requires:
Parameter | Usage |
---|---|
VPInstance instance |
Pointer to the instance this method call is intended for |
string host |
Hostname of uniserver; typically "universe.virtualparadise.org"
|
int port |
Port of uniserver; typically 57000
|
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_INITIALIZED |
SDK not initialized with vp_init() yet
|
VP_RC_CONNECTION_ERROR |
Error connecting to the universe server |
Behavior
- There is no special behavior for this method
Caveats
To disconnect from a universe, vp_destroy()
must be called.
Examples
int rc;
if(rc = vp_connect_universe(instance, "universe.virtualparadise.org", 57000))
printf("Error connecting to universe (reason %d)\n", rc);
See also
vp_destroy()
vp_login()