@deftypefun {int} {gnutls_x509_dn_get_rdn_ava} (gnutls_x509_dn_t @var{dn}, int @var{irdn}, int @var{iava}, gnutls_x509_ava_st * @var{ava})

@var{dn}: a pointer to DN

@var{irdn}: index of RDN

@var{iava}: index of AVA.

@var{ava}: Pointer to structure which will hold output information.

Get pointers to data within the DN. The format of the  @code{ava} structure

is shown below.

struct gnutls_x509_ava_st @{

gnutls_datum_t oid;

gnutls_datum_t value;

unsigned long value_tag;

@};

The X.509 distinguished name is a sequence of sequences of strings

and this is what the  @code{irdn} and  @code{iava} indexes model.

Note that  @code{ava} will contain pointers into the  @code{dn} structure which

in turns points to the original certificate. Thus you should not

modify any data or deallocate any of those.

This is a low-level function that requires the caller to do the

value conversions when necessary (e.g. from UCS-2).

@strong{Returns:} Returns 0 on success, or an error code.

@end deftypefun