@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