# EssGetVersion

Description

EssGetVersion() gets the full version number of the connected Essbase server, in the form Release.Version.Revision, e.g. 3.0.0.

Syntax

    ESS_FUNC_M EssGetVersion (hCtx, pRelease, pVersion, pRevision);

ESS_HCTX_T | hCtx
ESS_PUSHORT_T | pRelease
ESS_PUSHORT_T | pVersion
ESS_PUSHORT_T | pRevision

Parameters

hCtx | Essbase API context handle.
pRelease | Address of variable to receive release number.
pVersion | Address of variable to receive version number.
pRevision | Address of variable to receive revision number.

Return Value

If successful, returns the full incremental Essbase version number in pRelease, pVersion and pRevision.

Notes

- You can call this function after connecting to a server, to ensure that the Essbase server version supports all the features used by your program.

Access

This function requires no special privileges.

Example

    ESS_FUNC_M
    ESS_GetVersion (ESS_HCTX_T  hCtx)
    {
       ESS_FUNC_M     sts = ESS_STS_NOERR;
       ESS_USHORT_T  Release;
       ESS_USHORT_T  Version;
       ESS_USHORT_T  Revision;

       sts = EssGetVersion (hCtx, &Release, &Version,
             &Revision);
       if (!sts)
       {
          printf ("\r\nEssbase Application Server - Version %d.%d.%d\r\n", Release, Version, Revision);
       }

      return (sts);
    }

See Also

EssInit()