# dkim_sig_getsigntime()

[back to index]

SYNOPSIS

    #include <dkim.h>
    DKIM_STAT dkim_sig_getsigntime(
    	DKIM_SIGINFO *sig,
            uint64_t *when
    );

Retrieve the signature timestamp used to sign a message after verification.

DESCRIPTION

Called When | `dkim_sig_getsigntime()` is called after either an explicit call to `dkim_sig_process()` or completion of `dkim_eom()` to get the timestamp included in the signature of a message.

ARGUMENTS

Argument | Description
--- | ---
sig | Signature-specific handle.
time | A pointer to a `uint64_t` that will receive the timestamp of the signature on the message. The value is computed the same way as a `time_t`, but allows for larger integers.

RETURN VALUES

Value | Description
--- | ---
`DKIM_STAT_INVALID` | The signature referenced by the `DKIM_SIGINFO` handle did not contain a signature with a timestamp.
`DKIM_STAT_OK` | Successful completion.

NOTES

- None.

Copyright (c) 2007 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2009-2011, The OpenDKIM Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the respective licenses.