| SYNOPSIS |
#include <dkim.h>
DKIM_STAT dkim_sig_getqueries(
DKIM *dkim,
DKIM_SIGINFO *sig,
DKIM_QUERYINFO ***qi,
unsigned int *nqi
);
Given a signature handle, return the DNS query or queries that would be
required to complete verification of that signature.
|
|---|
| DESCRIPTION |
| Called When |
dkim_sig_getqueries() can be called at any time after
signature handles are completely received and stored via a call to
dkim_eoh(). |
|
|---|
| ARGUMENTS |
| Argument | Description |
|---|
| dkim |
Message-specific handle, previously returned by
dkim_verify(). |
| sig |
Signature-specific handle, acquired from
dkim_getsiglist(). |
| 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.
|