diagGetDescriptionVersion

Valid for: CANoe DE

Function Syntax

long diagGetDescriptionVersion (char buffer[], dword bufferLen); // form 1
long diagGetDescriptionVersion (char ecuQualifier[], char buffer[], dword bufferLen); // form 2

Description

Returns information on a diagnostic description, as stored in the database file itself.

Parameters

ecuQualifier: Retrieves information for this diagnostic description. If not given, the currently selected target or description assigned to the ECU simulation is used.
buffer: The value is written into this array.
bufferLen: Capacity of the array

Return Values

Number of characters written into the array, or error code. If a value is not defined in the database, 0 and an empty string are returned.

Example

char buffer[300];
DiagGetDescriptionInformation("ECU1", "", buffer, elcount(buffer));
write(buffer);
/* Example output:
Qualifier: ECU1
Name: ABCD2015
File: C:\Projects\2015\R123\ABCD.cdd
Manufacturer: Vector
Last history change: 2014-07-11 08:32:23+02:00
File version: 1.3 #132
Template version: 14.20.19 #1
*/
DiagSetTarget("ECU1");
DiagGetDescriptionVersion(buffer, elcount(buffer));
// returns "1.3"