Blame doc/functions/gnutls_x509_crt_get_issuer_alt_name2

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