| SYNOPSIS |
#include <dkim.h>
DKIM_STAT dkim_getkeysize(
DKIM *dkim,
unsigned int *bits
);
Retrieve the number of bits in the key used to verify a message.
|
| DESCRIPTION |
| Called When |
dkim_getkeysize() is called after
dkim_eom() to get the number of
bits in the key used to validate a message. The value returned
is only meaningful if dkim_eom() returned either
DKIM_STAT_OK or DKIM_STAT_BADSIG; the returned value
is otherwise undefined. |
|
|---|
| ARGUMENTS |
| Argument | Description |
| dkim |
Message-specific handle, returned by
dkim_verify.
|
| bits |
A pointer to an unsigned int which will receive the number
of bits in the key used to verify the message.
|
|
| RETURN VALUES |
| Value | Description |
| DKIM_STAT_INVALID |
The function was called before dkim_eom, or with
a handle that was not opened for verification.
|
| DKIM_STAT_OK |
Successful completion.
|
|
| NOTES |
- This function is a local addition to the formal API specification
and is experimental only. It may not appear in other implementations.
|