gnutls_certificate_get_openpgp_crt(3)

Usage

#include <gnutls/openpgp.h>

int gnutls_certificate_get_openpgp_crt(gnutls_certificate_credentials_t res, unsigned index, gnutls_openpgp_crt_t ** crt_list, unsigned * crt_list_size);

Arguments

`gnutls_certificate_credentials_t res`	is a `gnutls_certificate_credentials_t` type.
`unsigned index`	The index of the certificate list to obtain.
`gnutls_openpgp_crt_t ** crt_list`	Where to store the certificate list.
`unsigned * crt_list_size`	-- undescribed --

Overview

Obtains a X.509 certificate list that has been stored in res with one of gnutls_certificate_set_openpgp_key(), gnutls_certificate_set_openpgp_key_file(), gnutls_certificate_set_openpgp_key_file2(), gnutls_certificate_set_openpgp_key_mem(), or gnutls_certificate_set_openpgp_key_mem2(). Each certificate in the returned certificate list must be deallocated with gnutls_openpgp_crt_deinit(), and the list itself must be freed with gnutls_free().

If there is no certificate with the given index, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned. If the certificate with the given index is not a X.509 certificate, GNUTLS_E_INVALID_REQUEST is returned.

Returns

GNUTLS_E_SUCCESS (0) on success, or a negative error code.

Since

3.4.0