kernelv_set_options()
Prototyp
KERNELV_RETURN | kernelv_set_options (unsigned long int optionsMask); |
Beschreibung
Mit dieser Funktion kernelv-interne Funktionen wie z.B. die Ausgabe von Meldungen während der Lizenzprüfung aktiviert werden.
Abhängig von der zu aktivierenden Funktion muss diese Funktion eventuell vor der Funktion kernelv_startup() aufgerufen werden.
Jeder Funktionalität ist ein Bit im Aufrufparameter dieser Funktion zugeordnet. Die Funktionalität wird durch Setzen des entsprechenden Bits aktiviert.
Sollen mehrere Funktionalitäten aktiviert werden, so ergibt sich die resultierende Bitleiste aus der ODER-Verknüpfung der einzelnen Bitmasken.
Falls in der der Funktion übergebenen Bitleiste Bits gesetzt sind, denen keine Funktionalität zugeordnet ist, werden die unbekannten Bits ignoriert und der Wert ERR_UNKNOWN_OPTION zurückgegeben. Auch in diesem Fall werden die bekannten Bits ausgewertet und die zugeordneten Funktionalitäten aktiviert.
Parameter
Name | Typ | Bedeutung |
optionsMask | unsigned long | Bitleiste mit Optionen. |
Mögliche Werte für die Bitmaske sind:
Symbol | Wert | Bedeutung |
KERNELV_OPTION_ | 0x1 | Während der Lizenzprüfung beim Hochlauf werden Meldungen zum Ablauf der Lizenzprüfung ausgegeben. Dient zur Fehlersuche bei Lizenzierungsproblemen. |
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. |