Vp init: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
Oliver (talk | contribs)
Added headings. Pointless headings
Sleepy E (talk | contribs)
mNo edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<C>int vp_init(int version)</C>
{{sdk method page|init|Check if the version of the VPSDK used to build the application matches the version that is currently loaded.
|customparam={{sdk parameter|int|version}}
|customparamex=VPSDK_VERSION
|noinstanceparam=
|parameters=
  {{sdk parameter row|int|version|{{code|VPSDK_VERSION}} in VP.h defines the version of the SDK library}}
|behavior=
There is no longer a requirement to call this function. It is used to check if the version used to build the application is compatible with the version used at runtime.
|returncodes=
  {{sdk return code row|version_mismatch|VP.h and the SDK library are from different builds}}
|examples=
<syntaxhighlight lang="c">
int rc;


== Description ==
if (rc = vp_init(VPSDK_VERSION))
Initializes the VP API.
     printf("Incorrect VPSDK.dll version\n");
 
</syntaxhighlight>
== Callback ==
|seealso=
None
* {{sdk method|create}}
 
}}
== Notes ==
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.
 
== Arguments ==
;version:VP_BUILD in VP.h defines the build of the SDK library.
 
== Argument attributes ==
None
 
== Return values ==
;[[SDK Reason Codes#VP_RC_SUCCESS|VP_RC_SUCCESS]]
;[[SDK Reason Codes#VP_RC_VERSION_MISMATCH|VP_RC_VERSION_MISMATCH]]:VP.h and the SDK library are from different builds.
 
== Returned attributes ==
None
 
== Example ==
<C>
int rc;
if(rc = vp_init(VP_BUILD))
     printf("Error initializing VP API(reason %d)\n", rc);
</C>

Latest revision as of 19:14, 1 August 2018

Method call snippet vp_init(VPSDK_VERSION);

Check if the version of the VPSDK used to build the application matches the version that is currently loaded.

Parameters

These are the parameters that this method requires:

Parameter Usage
int
version
VPSDK_VERSION in VP.h defines the version 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

There is no longer a requirement to call this function. 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(VPSDK_VERSION))
    printf("Incorrect VPSDK.dll version\n");

See also