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.