@deftypefun {int} {gnutls_x509_privkey_get_key_id} (gnutls_x509_privkey_t @var{key}, unsigned int @var{flags}, unsigned char * @var{output_data}, size_t * @var{output_data_size})
@var{key}: a key
@var{flags}: should be one of the flags from @code{gnutls_keyid_flags_t}
@var{output_data}: will contain the key ID
@var{output_data_size}: holds the size of output_data (and will be
replaced by the actual size of parameters)
This function will return a unique ID that depends on the public key
parameters. This ID can be used in checking whether a certificate
corresponds to the given key.
If the buffer provided is not long enough to hold the output, then
* @code{output_data_size} is updated and @code{GNUTLS_E_SHORT_MEMORY_BUFFER} will
be returned. The output will normally be a SHA-1 hash output,
which is 20 bytes.
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
negative error value.
@end deftypefun