---
name: "gnutls_openpgp_privkey_set_preferred_key_id"
section: "3"
platform: "linux"
package: "gnutls-doc"
version: "3.5.8-5+deb9u5"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_openpgp_privkey_set_preferred_key_id"
---

# gnutls\_openpgp\_privkey\_set\_preferred\_key\_id(3)

API function

## NAME

gnutls\_openpgp\_privkey\_set\_preferred\_key\_id - API function

## SYNOPSIS

**#include \<gnutls/openpgp.h\>**

**int gnutls\_openpgp\_privkey\_set\_preferred\_key\_id(gnutls\_openpgp\_privkey\_t** *key***, const gnutls\_openpgp\_keyid\_t**          *keyid***);**

## ARGUMENTS

- gnutls\_openpgp\_privkey\_t key

  the structure that contains the OpenPGP public key.

- const gnutls\_openpgp\_keyid\_t keyid

  the selected keyid

## DESCRIPTION

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  *keyid* is **NULL** then the master key is set as preferred.

## RETURNS

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise a negative error code is returned.

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: http://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2020 Free Software Foundation, Inc., and others.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

- http://www.gnutls.org/manual/