gnutls_subject_alt_names_get(3)

NAME
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 structure

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 structure. 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

COPYRIGHT
Copyright © 2001-2014 Free Software Foundation, Inc..
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/