kernelv_ch_get_filename()

Prototyp

KERNELV_RETURN

kernelv_ch_get_filename (unsigned long int chanIndex,
                                          char *filename,
                                          unsigned short int nameLength,
                                          unsigned short int* returnLength);

Beschreibung

Lesen des Dateinamens des aktuell im Kanal aktiven Programms.

Parameter

Name	Typ	Bedeutung
chanIndex	unsigned long	Kanalindex des Kanals dessen Dateiname gelesen werden soll.
filename	char*	Zeiger auf den Speicherplatz für den Dateinamen.
nameLength	unsigned short	Länge des Speicherbereiches für den Dateinamen.
returnLength	unsigned short*	Zeiger auf den Wert, in den die tatsächlich zurückgegebene Anzahl Bytes geschrieben werden soll. Es wird die Anzahl der Zeichen des Dateinamens +1 zurückgegeben.

Rückgabewerte

Symbol	Wert	Bedeutung
RET_FINISHED	0	Die Funktion wurde fehlerfrei durchgeführt.
ERR_INVALID_CHAN	-1	Der übergebene Kanalindex ist größer als die Anzahl der konfigurierten Kanäle -1.
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 returnLength wird in diesem Fall der benötigte Speicher inklusive der terminierenden 0 zurückgegeben.