# dk_getidentity()

SYNOPSIS |
    #include <dk.h>
    DK_STAT dk_getidentity(
    	DK *dk,
            char *hname,
    	size_t hnamelen,
            char *hval,
            size_t hvallen
    );
Retrieve the apparent signer's identity and/or the name of the header used to determine the identity.
DESCRIPTION |
Called When | `dk_getidentity()` is called after `dk_eoh()` to get the header that represents the signer's identity, and the decommented value of that header.
ARGUMENTS |
Argument | Description
--- | ---
dk | Message-specific handle, returned by `dk_sign()` or `dk_verify`.
hname | A pointer to a character buffer into which should be written the name of the header from which the signer's identity was taken. Can be NULL if this information is not needed by the caller.
hnamelen | The number of bytes available at `hname`.
hval | A pointer to a character buffer into which should be written the value, with RFC2822 comments removed, of the header from which the signer's identity was taken. Can be NULL if this information is not needed by the caller.
hvallen | The number of bytes available at `hval`.
NOTES | This function is a local addition to the formal API specification and is experimental only. It may not appear in other implementations.

Copyright (c) 2004 Sendmail, Inc. and its suppliers. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the LICENSE.