ec_log_permanent_failure
Name
ec_log_permanent_failure — Records a permanent failure disposition of a message
Synopsis
#include "log.h"
| void **ec_log_permanent_failure** (
| mess, | |
| | dr, | |
| | now, | |
| | note)
; | |
ec_message * <var class="pdparam">mess</var>
;
domain_record * <var class="pdparam">dr</var>
;
struct timeval * <var class="pdparam">now</var>
;
const string * <var class="pdparam">note</var>
;
Description
Records a permanent failure disposition of a message.
- mess
-
A pointer to an ec_message struct. For documentation of this data structure see “ec_message”.
- dr
-
A pointer to a domain_record struct. For documentation of this data structure see “domain_record”.
- now
-
A pointer to a timeval struct, which may be NULL.
**Configuration Change. ** Prior to version 3.0, NULL was not an allowed value.
- note
-
Typical use is to pass
NULL
to this parameter, in which case the string is pulled from the message construct. You may override this by passingstring
a DSN to use for logging the permanent failure.
This function returns void.
It is legal to call this function in any thread.