# dkim_getdomain()

[back to index]

SYNOPSIS |
    #include <dkim.h>

    const char * dkim_getdomain(
    	DKIM *dkim
    );
Retrieve the sending domain associated with a message.
DESCRIPTION |
Called When | `dkim_getdomain()` can be called at any time after a handle is initialized with a call to `dkim_sign()` or `dkim_verify()`.
ARGUMENTS |
Argument | Description
--- | ---
dkim | Message-specific handle, returned by `dkim_sign()` or `dkim_verify()`.
RETURN VALUES |
Value | Description
--- | ---
`NULL` | The sending domain has not or could not be determined from the message represented by this handle.
otherwise | A pointer to the sending domain.
NOTES | This domain is selected by finding the first header field matching the sender header field name list as set by the `DKIM_OPTS_SENDERHDRS` option or its default (see `dkim_options`). Note that it is not guaranteed that this field was included in the set of fields fed to the DKIM signature hashes (assuming it was signed), and in any case its value may or may not have been valid at the time the message was generated.

Copyright (c) 2007 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2009-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.