kernelv_get_api_version()

Prototyp

KERNELV_RETURN

kernelv_get_api_version (char* versionString,
                                         unsigned long maxStringLength,
                                         unsigned long* returnSize);

Beschreibung

Versionsstring der API lesen.

Parameter

Name

Typ

Bedeutung

versionString

char*

Zeiger auf den Speicherort des Versionsstrings, der Speicher ist von der Applikation bereitzustellen.

maxStringLength

unsigned long

Länge des von der Applikation bereitgestellten Speichers (in Bytes).

returnSize

unsigned long*

Länge des zurückgelieferten Versionsstrings. Falls ein Fehler aufgetreten ist, wird der Wert 0 zurückgegeben.

Rückgabewerte

Symbol

Wert

Bedeutung

RET_FINISHED

0

Die Funktion wurde fehlerfrei durchgeführt.

ERR_CNC_NOT_INIT

-3

Der Simulations-CNC-Kern ist noch nicht initialisiert.

ERR_CNC_RET_MEMORY

-4

Der oder die Rückgabewerte passen nicht in den bereitgestellten Speicher. Im Parameter returnSize wird die Anzahl der benötigten Bytes inklusive der terminierenden Null zurückgegeben.