Blame doc/functions/gnutls_x509_crt_get_issuer_alt_name2

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_x509_crt_get_issuer_alt_name2} (gnutls_x509_crt_t @var{cert}, unsigned int @var{seq}, void * @var{ian}, size_t * @var{ian_size}, unsigned int * @var{ian_type}, unsigned int * @var{critical})
Packit aea12f
@var{cert}: should contain a @code{gnutls_x509_crt_t}  type
Packit aea12f
Packit aea12f
@var{seq}: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
Packit aea12f
Packit aea12f
@var{ian}: is the place where the alternative name will be copied to
Packit aea12f
Packit aea12f
@var{ian_size}: holds the size of ret.
Packit aea12f
Packit aea12f
@var{ian_type}: holds the type of the alternative name (one of gnutls_x509_subject_alt_name_t).
Packit aea12f
Packit aea12f
@var{critical}: will be non-zero if the extension is marked as critical (may be null)
Packit aea12f
Packit aea12f
This function will return the alternative names, contained in the
Packit aea12f
given certificate. It is the same as
Packit aea12f
@code{gnutls_x509_crt_get_issuer_alt_name()}  except for the fact that it
Packit aea12f
will return the type of the alternative name in  @code{ian_type} even if
Packit aea12f
the function fails for some reason (i.e.  the buffer provided is
Packit aea12f
not enough).
Packit aea12f
Packit aea12f
@strong{Returns:} the alternative issuer name type on success, one of the
Packit aea12f
enumerated @code{gnutls_x509_subject_alt_name_t} .  It will return
Packit aea12f
@code{GNUTLS_E_SHORT_MEMORY_BUFFER}  if  @code{ian_size} is not large enough
Packit aea12f
to hold the value.  In that case  @code{ian_size} will be updated with
Packit aea12f
the required size.  If the certificate does not have an
Packit aea12f
Alternative name with the specified sequence number then
Packit aea12f
@code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  is returned.
Packit aea12f
Packit aea12f
@strong{Since:} 2.10.0
Packit aea12f
@end deftypefun