Vp init: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
m (added seealso)
m (updated syntax highlighting tags)
Line 10: Line 10:
   {{sdk return code row|version_mismatch|VP.h and the SDK library are from different builds}}
   {{sdk return code row|version_mismatch|VP.h and the SDK library are from different builds}}
|examples=
|examples=
<C>
<syntaxhighlight lang="c">
int rc;
int rc;
if(rc = vp_init(VP_BUILD))
if(rc = vp_init(VP_BUILD))
     printf("Error initializing VP API (reason %d)\n", rc);
     printf("Error initializing VP API (reason %d)\n", rc);
</C>
</syntaxhighlight>
|seealso=
|seealso=
* {{sdk method|create}}
* {{sdk method|create}}
}}
}}

Revision as of 18:06, 6 February 2015

Method call snippet vp_init(VP_BUILD);

Initializes the Virtual Paradise SDK, which is required before calling any other method of the SDK.

Parameters

These are the parameters that this method requires:

Parameter Usage
int
version
VP_BUILD in VP.h defines the build of the SDK library

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_VERSION_MISMATCH VP.h and the SDK library are from different builds

Behavior

This only has to be called once for every application. It is used to check if the version used to build the application is compatible with the version used at runtime.

Examples

int rc;
if(rc = vp_init(VP_BUILD))
    printf("Error initializing VP API (reason %d)\n", rc);

See also