| SYNOPSIS | 
#include <dkim.h>
DKIM_STAT dkim_sig_process(
	DKIM *dkim,
	DKIM_SIGINFO *sig
);
Runs verification on a signature, returning a result.  The function will
retrieve the key needed to verify the signature if that hasn't already
been done, and if called from the final
callback, compare the computed body hash to the one found in the
signature. 
Upon completion of processing of the signature, the caller may use
dkim_sig_getflags() and
dkim_sig_getbh() to
retrieve the results of the processing.  
 | 
|---|
| DESCRIPTION | 
| Called When | dkim_sig_process() can be called from within the user
    prescreen or
    final callbacks, if defined. |  | 
|---|
| ARGUMENTS | 
    | Argument | Description | 
|---|
 | dkim | DKIM handle, returned by a prior call to
	dkim_verify(). |  | sig | Signature-specific handle generated by the library. |  | 
|---|
| RETURN VALUES | 
    | Return Value | Description | 
|---|
 | DKIM_STAT_OK | Signature processing was completed. |  | DKIM_STAT_NORESOURCE | The library was unable to create one or more data structures
	required to complete the processing. |  | DKIM_STAT_CBERROR DKIM_STAT_CBINVALID
 DKIM_STAT_CBREJECT
 DKIM_STAT_CBTRYAGAIN
 | A registered lookup callback returned a non-completion
	result.  See DKIM_STAT for
	further details. |  | 
|---|
| NOTES | 
A positive result from dkim_sig_getflags() after calling
    this function during the prescreen callback is not sufficient to
    conclude that the signature is good, since at that time a final result
    from dkim_sig_getbh() is not available.  The latter must be
    tested in the final callback to ensure that the signature was good
    and the signature's body hash matched the one computed by the
    library.
 |