Skip to main content

EricRegistriereLogCallback

Function EricRegistriereLogCallback 

Source
pub unsafe extern "C" fn EricRegistriereLogCallback(
    funktion: EricLogCallback,
    schreibeEricLogDatei: u32,
    benutzerdaten: *mut c_void,
) -> c_int
Expand description

@brief Die registrierte @c funktion wird als Callback-Funktion für jede Lognachricht aufgerufen. Die Ausgabe entspricht einer Zeile im eric.log.

@param[in] funktion Zeiger auf die zu registrierende Funktion oder NULL. @param[in] schreibeEricLogDatei @parblock Log-Nachrichten im eric.log: @mAbsatz - \c 1 Jede Log-Nachricht wird nach eric.log geschrieben. Der Parameter \c funktion kann auf eine Funktion zeigen oder \c NULL sein. - \c 0 Falls \c funktion \c != \c NULL werden keine Log-Nachrichten nach eric.log geschrieben, andernfalls werden die Log-Nachrichten nach eric.log geschrieben. @endparblock @param[in] benutzerdaten @parblock Zeiger, welcher der registrierten Funktion immer mitgegeben wird.

         Die Anwendung kann diesen Parameter
         dazu verwenden, einen Zeiger auf eigene Daten oder
         Funktionen an die zu registrierende Funktion
         übergeben zu lassen.
 @endparblock

@return

  • ::ERIC_OK
  • ::ERIC_GLOBAL_UNGUELTIGER_PARAMETER
  • ::ERIC_GLOBAL_NICHT_GENUEGEND_ARBEITSSPEICHER
  • ::ERIC_GLOBAL_UNKNOWN

@remark - Wenn eine zuvor registrierte Funktion nicht mehr aufgerufen werden soll, ist ::EricRegistriereLogCallback() mit dem Wert \c NULL im Parameter \c funktion aufzurufen (=Deregistrierung). - Vor dem Beenden der Steueranwendung ist eine registrierte Funktion zu deregistrieren, da es sonst zu einem Absturz kommen kann. - Es ist nicht erlaubt eine ERiC API-Funktion aus einer Callback-Funktion aufzurufen. - Die Verarbeitung im Callback findet synchron statt. Deshalb sollte der Callback sehr schnell ausgeführt werden.