| SYNOPSIS | 
#include <dkim.h>
DKIM *dkim_verify(
	DKIM_LIB *libhandle,
	const char *id,
	void *memclosure,
	DKIM_STAT *statp
);
Create a new handle for verifying a (possibly) signed message. | 
|---|
| DESCRIPTION | 
| Called When | dkim_verify() is called when preparing to process a new message
    that may be signed already in order to be able to verify its contents
    against the signature. |  | 
|---|
| ARGUMENTS | 
    | Argument | Description | 
|---|
 | libhandle | DKIM library instance handle, returned by
        an earlier call to dkim_init(). |  | id | An opaque, printable string for identifying this message,
            suitable for use in logging or debug output. |  | memclosure | Opaque memory closure, passed directly to the caller-provided
            malloc() and/or free() replacement functions. |  | statp | Pointer to a DKIM_STAT
            object which receives the completion status of this operation. |  | 
|---|
| NOTES | 
The handle returned by this function may not be used in a later call
    to dkim_getsighdr().
 | 
| RETURN VALUES | 
On success, a pointer to the created DKIM
    handle is returned.
On failure, NULL is returned and the value of statp is updated
    to indicate the cause of the problem.
 |