| SYNOPSIS | 
#include <dkim.h>
DKIM_STAT dkim_add_querymethod(
	DKIM *dkim,
        const char *method,
        const char *options);
);
Requests that a signature be generated such that it requests verifiers use
the specified query method and options (if any) to retrieve
the verifying key.  This adds the q= tag showing the specified
method(s) and option(s) when the signature is generated by
dkim_getsighdr().  Multiple
query methods can be listed by making multiple calls to this function. | 
|---|
| DESCRIPTION | 
| Called When | dkim_add_querymethod() can be called at any time prior to calling
dkim_eom(). |  | 
|---|
| ARGUMENTS | 
    | Argument | Description | 
|---|
 | dkim | Message-specific signing handle, returned by
        dkim_sign(). |  | method | A pointer to a null-terminated string that specifies the
	key retrieval method to be used by verifiers.  This value will
	appear in the q= value of the generated signature. |  | options | A pointer to a null-terminated string that specifies the
	query options to be used by the verifier, or NULL if no options should
	be shown in the signature. |  | 
|---|
| RETURN VALUES | 
DKIM_STAT_OK -- success
DKIM_STAT_INVALID -- dkim referred to a verifying header rather
    than a signing header, or one of the provided values contained a syntax
    error, or a request was made to add a method or method-option pair that was
    already requested for the same signature
DKIM_STAT_NORESOURCE -- out of memory
 | 
| NOTES | 
To support experimental extensions, methods not listed in RFC6376
    are permitted.
 |