dkim_resign()

SYNOPSIS

#include <dkim.h>

DKIM_STAT dkim_resign(
	DKIM *sh,
	DKIM *eh,
	bool hdrbind
);

Binds a signing handle to another handle to generate a second signature for a message being signed or verified. The message therefore only passes through the library once, but now produces either a verification result and a new signature, or multiple signatures.

DESCRIPTION

Called When	`dkim_resign()` must be called after a signing handle is acquired with `dkim_sign()` and a separate (signing or verifying) handle is acquired with `dkim_sign()` or `dkim_verify()`, but before any message data has been passed to either one.

ARGUMENTS

Argument	Description
sh	Message-specific handle, returned by `dkim_sign()`. It must not have been used to process any message data (i.e., no prior calls to `dkim_header()` or `dkim_eoh()`.
eh	Message-specific handle, returned by `dkim_sign()` or `dkim_verify()`. `dkim_eoh()` must not already have been called.
hdrbind	If TRUE, indicates that both the header and the body of the message are bound to the verifying handle. If FALSE, only the body is bound, meaning the caller must provide a complete (but possibly different) set of header fields using `dkim_header()` prior to calling `dkim_eoh()`.

RETURN VALUES

One or more of the following:

sh is not a signing handle
eh has already been passed to dkim_eoh()
eh is already bound to another handle by a previous call to this function

Value	Description
`DKIM_STAT_OK`	The binding was successful.
`DKIM_STAT_INVALID`

NOTES