| SYNOPSIS |
#include <dkim.h>
DKIM_STAT dkim_policy_getqueries(
DKIM *dkim,
DKIM_QUERYINFO **qi,
unsigned int *nqi
);
Given a DKIM handle, return the DNS query or queries that would be
required to complete an ADSP evaluation of that message. This is in addition
to any DNS queries needed to complete validation of individual signatures.
|
|---|
| DESCRIPTION |
| Called When |
dkim_policy_getqueries() can be called at any time after
header fields are completely received and stored via a call to
dkim_eoh(). |
|
|---|
| ARGUMENTS |
| Argument | Description |
|---|
| dkim |
Message-specific handle. The handle must be one created
for message verification via a call to
dkim_verify(). |
| qi |
An array of DKIM_QUERYINFO handles allocated by the
the library to return the set of required DNS queries.
|
| nqi |
The number of elements in the qi array.
|
|
|---|
| RETURN VALUES |
| Value | Description |
|---|
| DKIM_STAT_NORESOURCE |
Memory could not be allocated for the new array.
|
| DKIM_STAT_OK |
The array was allocated and returned.
|
|
|---|
| NOTES |
- The caller is responsible for deallocating the array and each element of it
returned function.
|