# 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_ LICENSE_CHECK_VERBOSE | 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.