UC_ResetLastLogMessages

 bool UC_ResetLastLogMessages (int $InstanzID) 

Parameterliste

Rückgabewert

Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Die Funktion leert die Puffer aller Meldungstypen, deren Inhalt UC_GetLastLogMessages liefert. Anschließend liefert UC_GetLastLogMessages nur noch Meldungen, die nach dem Aufruf ins Log geschrieben wurden. Das Log bzw. die Logdateien selbst werden nicht verändert.

Die Zähler von UC_GetLogMessageStatistics bleiben erhalten, sie werden mit UC_ResetLogMessageStatistics zurückgesetzt.

Die ID der Util Control Instanz liefert z.B. IPS_GetInstanceListByModuleID mit der Modul-GUID {B69010EA-96D5-46DF-B885-24821B8C8DBD}. Existiert InstanzID nicht, schlägt die Funktion mit "Instance #... does not exist" fehl, gehört die Instanz zu einem anderen Modul, mit "Instance does not implement this function".

Beispiel

// ID der Util Control Instanz ermitteln
$id = IPS_GetInstanceListByModuleID('{B69010EA-96D5-46DF-B885-24821B8C8DBD}')[0];

UC_ResetLastLogMessages($id);

// Liefert nun ein leeres Array, bis wieder eine Fehlermeldung auftritt
print_r(UC_GetLastLogMessages($id, KL_ERROR - KL_MESSAGE));