Tivoli Header

Tivoli Storage Manager Using the Application Program Interface

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 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.

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.1.0.0, then, after returning from the call, the fields of the structure contain the following values:

Return Codes

There are no return codes that are specific to this call.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]