dkim_ohdrs()

SYNOPSIS
#include <dkim.h>
DKIM_STAT dkim_ohdrs(
	DKIM *dkim,
        char **ptrs, int *pcnt)
);
Retrieve the original header set from the "z=" tag in a received signature if present.
DESCRIPTION
Called When dkim_ohdrs() is called in dkim_eom() to get the original header set included in the signature of a message, if present, for diagnostic purposes. The original headers can be compared to the received headers to detect modifications in transit which prevented successful verification of the message.
ARGUMENTS
ArgumentDescription
dkim Message-specific handle, returned by dkim_verify.
ptrs A pointer to a an array of (char *) pointers which will be updated to point to the original headers.
ptrs On input, this is used as the count of available pointers in the ptrs array. When returned, this value indicates the number of headers available. If it is higher on return than it was when called, then there were more headers than there were pointers provided.
RETURN VALUES
ValueDescription
DKIM_STAT_INVALID The function was called before dkim_eom, or with a handle that was not opened for verification.
DKIM_STAT_INVALID The value contained in the "z=" tag contained corruption.
DKIM_STAT_NORESOURCE A memory allocation operation failed.
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.
  • The first parameter to this function should ideally be a DKIM_SIGINFO. This will change as full multiple signature support becomes available.

Copyright (c) 2007 Sendmail, Inc. and its suppliers. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the LICENSE.