| SYNOPSIS | 
#include <dkim.h>
DKIM_STAT dkim_sig_getidentity(
	DKIM *dkim,
	DKIM_SIGINFO *sig,
        char *val,
        size_t vallen
);
Retrieve the signing identity from a signature handle. | 
|---|
| DESCRIPTION | 
| Called When | dkim_sig_getidentity() is called after
    dkim_eoh() to determine
    the identity associated with a signature. |  | 
|---|
| ARGUMENTS | 
    | Argument | Description | 
|---|
 | dkim | Message-specific handle, returned by
        dkim_sign() or
        dkim_verify. |  | sig | The DKIM_SIGINFO handle representing the signature
	being evaluated. |  | val | A character buffer to receive the identity extracted
	    from the signature.  The value may be explicitly defined
	    in the signature's "i=" tag, or inferred from its absence. |  | vallen | Number of bytes available at val. |  | 
|---|
| RETURN VALUES | 
DKIM_STAT_OK -- successful completion
DKIM_STAT_SYNTAX -- some part of the input string was invalid
DKIM_STAT_NORESOURCE -- val did not contain enough space
    for the complete identity string
 |