Wird beim Empfang einer E-Mail aufgerufen bzw. bei deren Speicherung in der Mailbox eines Benutzers.
In $mail wird eine Referenz auf ein BMMail-Objekt übergeben, das die E-Mail repräsentiert. In $mailbox wird eine Referenz auf das BMMailbox-Objekt des Benutzers übergeben, in $user eine Referenz auf das BMUser-Objekt des Benutzers.
Die Funktion kann verschiedene Werte zurückgeben, um zu definieren, wie mit der E-Mail weiter verfahren werden soll. Die Werte werden von b1gMail in folgenden Konstanten definiert:
• BM_OK – Die E-Mail wird normal weiter verarbeitet
• BM_BLOCK – Die E-Mail wird geblockt (d.h. gelöscht mit Benachrichtigung an den Absender)
• BM_DELETE – Die E-Mail wird gelöscht (ohne Benachrichtigung an den Absender)
• BM_IS_INFECTED – Die E-Mail wird wie eine mit einem Virus infizierte E-Mail behandelt
• BM_IS_SPAM – Die E-Mail wird wie eine Spam-E-Mail behandelt