gnutls_subject_alt_names_get man page

gnutls_subject_alt_names_get — API function

Synopsis

#include <gnutls/x509-ext.h>

int gnutls_subject_alt_names_get(gnutls_subject_alt_names_t sans, unsigned int seq, unsigned int * san_type, gnutls_datum_t * san, gnutls_datum_t * othername_oid);

Arguments

gnutls_subject_alt_names_t sans
The alternative names
unsigned int seq
The index of the name to get
unsigned int * san_type
Will hold the type of the name (of gnutls_subject_alt_names_t)
gnutls_datum_t * san
The alternative name data (should be treated as constant)
gnutls_datum_t * othername_oid
The object identifier if san_type is GNUTLS_SAN_OTHERNAME (should be treated as constant)

Description

This function will return a specific alternative name as stored in the sans type. The returned values should be treated as constant and valid for the lifetime of sans .

Returns

On success, GNUTLS_E_SUCCESS (0) is returned, GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the index is out of bounds, otherwise a negative error value.

Since

3.3.0

Reporting Bugs

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

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/

Info

3.5.5 gnutls gnutls