dsmQueryApiVersionEx
The dsmQueryApiVersionEx function call performs a query request for the API library version that the application client accesses.
All updates to the API are made in an upward-compatible format. Any application client that has an API version or release less than or equal to the API library on the end user's workstation operates without change. See Summary of Code Changes in the README_api_enu file for exceptions to upward compatibility. If the dsmQueryApiVersionEx call returns a version or version release that is different from that of the application client, be aware before you proceed that some API calls might be enhanced in a manner that is not supported by the end user's older version of the API.
The application API version number is stored in the dsmapitd.h header file as constants DSM_API_VERSION, DSM_API_RELEASE, DSM_API_LEVEL, and DSM_API_SUBLEVEL.
There are no return codes that are specific to this call.
Syntax
void dsmQueryApiVersionEx (dsmApiVersionEx *apiVersionP);Parameters
- dsmApiVersionEx *apiVersionP (O)
- This parameter is a pointer to the structure that contains the API library's version, release,
level, and sublevel components. For example, if the library is version 5.5.0.0, then, after
returning from the call, the fields of the structure contain the following values:
ApiVersionP->version = 5ApiVersionP->release = 5ApiVersionP->level = 0ApiVersionP->subLevel = 0