Index

C/C++ Functions

dtEngineGetVersion

DT_SLONG dtEngineGetVersion(DT_DTENGINE engine, DT_CHAR* ver_name, DT_CHAR* ver_snum, DT_CHAR* reserved)

Short Description: Get D-Type Standard Engine version

This function returns the version of D-Type Standard Engine being utilized.

Parameters

ParameterDescription

engine

Handle of the previously created Standard Engine instance.

ver_name

A valid pointer to a buffer supplied by your application that will hold the name of the engine, expressed as a standard ANSI C/C++ string. The size of this buffer must be at least 255 bytes.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

ver_snum

A valid pointer to a buffer supplied by your application that will hold the version number of the engine, expressed as a standard ANSI C/C++ string in the following format:

ReleaseNumber.VersionNumber.SubVersionNumber.BuildNr

The size of this buffer must be at least 16 bytes.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

reserved

A valid pointer to a buffer reserved for future use. The size of this buffer must be at least 255 bytes. At present, the engine will write an empty string to this buffer.

However, if you do not wish to receive the value of the above parameter, you may set this pointer to DV_NULL.

Return Value

The function returns the version number of D-Type Standard Engine being utilized and expressed as an integer. The larger this number is, the more mature the engine is.

Example

DT_CHAR reserved[255];
DT_CHAR ver_name[255];
DT_CHAR ver_snum[16];
DT_SLONG ver_num = dtEngineGetVersion(engine, ver_name, ver_snum, reserved);

printf("%s version %s (%d)\r\n", ver_name, ver_snum, ver_num);

Output:

D-Type Standard Engine version 4.0.0.1 (4001)
 

Index