# dkim_policy_getqueries()

[back to index]

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.

Copyright (c) 2007 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2011, The Trusted Domain Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the respective licenses.