kernelv_program_error_get_file_name
Prototyp
KERNELV_RETURN
| ProgramErrorGetFileName (out string returnString); |
Beschreibung
Liefert den Dateinamen des aktiven NC-Programms zurück.
Falls das Programm durch Angabe eines absoluten Programmnamens gestartet wurde, wird der komplette Programmname zurückgegeben.
Falls die CNC-Steuerung das NC-Programm unter Benutzung eines Suchpfades öffnete, wird von dieser Funktion der beim Programmstart angegebene Dateiname zurückgegeben, der verwendete Suchpfad kann mit der Funktion kernelv_program_error_get_path() abgefragt werden.
Falls der vom Aufrufer bereitgestellte Speicher zu klein für die zurückzugebende Zeichenkette ist, wird der Rückgabewert ERR_CNC_RET_MEMORY zurückgegeben.
Parameter
Name | Typ | Bedeutung |
returnString | out string | Zeichenkette für den Programmpfad. |
Rückgabewerte
Symbol | Wert | Bedeutung |
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt. |
ERR_CNC_RET_MEMORY | -4 | Der oder die Rückgabewerte passen nicht in den bereitgestellten Speicher. Im Parameter length wird die Anzahl der benötigten Bytes zurückgegeben. |
ERR_CNC_NO_DATA | -28 | Die angeforderten Daten sind nicht verfügbar. Es liegen keine NC-programmspezifischen Daten zu einem CNC-Fehler vor. |