| SYNOPSIS | 
#include <dkim.h>
DKIM_STAT dkim_set_signer(
	DKIM *dkim,
        const unsigned char *signer);
);
Specifies the signer to be included in the signature being generated.
This will cause the "i=" tag to be added to the signature when it
gets generated.
 | 
| DESCRIPTION | 
| Called When | 
dkim_set_signer() can be called at any time prior to signature
generation. | 
 
 
 | 
|---|
| ARGUMENTS | 
    
    | Argument | Description |  
    | dkim | 
	Message-specific signing handle, returned by
        dkim_sign().
	 |  
    | signer | 
	A pointer to a null-terminated string which specifies the
	entity which is responsible for the signature being
	generated.  This will cause an "i=" tag containing this value
	to be included in the signature generated by this handle.
	If not defined, no "i=" tag will be added, meaning verifiers
	should use an implied value.
	 |  
     
 | 
| RETURN VALUES |  
- DKIM_STAT_OK -- success
 - DKIM_STAT_INVALID -- dkim referred to a verifying header rather
    than a signing header
 - DKIM_STAT_NORESOURCE -- out of memory
  
 | 
| NOTES |  
 |