



@deftypefun {int} {gnutls_openpgp_privkey_set_preferred_key_id} (gnutls_openpgp_privkey_t @var{key}, const gnutls_openpgp_keyid_t          @var{keyid})
@var{key}: the structure that contains the OpenPGP public key.

@var{keyid}: the selected keyid

This allows setting a preferred key id for the given certificate.
This key will be used by functions that involve key handling.

If the provided  @code{keyid} is @code{NULL}  then the master key is
set as preferred.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
otherwise a negative error code is returned.
@end deftypefun
