| SYNOPSIS |
#include <dkim.h>
DKIM_STAT dkim_getsigntime(
DKIM *dkim,
time_t *when
);
Retrieve the signature timestamp used to sign a message after verification.
|
| DESCRIPTION |
| Called When |
dkim_getsigntime() is called after
dkim_eom() to get the
timestamp included in the signature of a message. |
|
|---|
| ARGUMENTS |
| Argument | Description |
| dkim |
Message-specific handle, returned by
dkim_verify.
|
| time |
A pointer to a time_t which will receive
the timestamp of the signature on the message.
|
|
| RETURN VALUES |
| Value | Description |
| DKIM_STAT_INVALID |
The function was called before dkim_eom, or with
a handle that was not opened for verification.
|
| DKIM_STAT_SYNTAX |
The message referenced by the DKIM handle did not contain
a signature with a timestamp, or the timestamp contained a syntax
error.
|
| DKIM_STAT_OK |
Successful completion.
|
|
| NOTES |
- This function is a local addition to the formal API specification
and is experimental only. It may not appear in other implementations.
|