dkim_set_signature_handle()

SYNOPSIS
#include <dkim.h>
DKIM_STAT dkim_set_signature_handle(
	DKIM_LIB *libdkim,
        void * (*func)(void *closure));
);
Defines a callback function to be used for allocating local data storage to be associated with signatures.

From within dkim_eoh(), each discovered signature is assigned a DKIM_SIGINFO handle. If this callback function is defined, it will be called once for each such handle to allocate any caller-side storage that might be desired by the caller; the return value is assumed to be a pointer to such storage, and can be retrieved later by the caller during signature processing.

DESCRIPTION
Called When dkim_set_signature_handle() must be called before dkim_eoh() has been called.
ARGUMENTS
ArgumentDescription
libdkim Library-specific handle, returned by dkim_init().
func A pointer to a function which takes a single void pointer that is the same as the memclosure passed to dkim_verify(). If NULL, no callback will be used.
RETURN VALUES
  • DKIM_STAT_OK -- success
NOTES
  • This function is a local addition to the formal API specification and is experimental only. It may not appear in other implementations.

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.