[back to index]

#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.
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.
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
DKIM_STAT_OK The binding was successful.

Copyright (c) 2009, 2010, 2012, The Trusted Domain Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the license.