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
NULLto this parameter, in which case the string is pulled from the message construct. You may override this by passingstringa DSN to use for logging the permanent failure.
This function returns void.
It is legal to call this function in any thread.