Blame doc/functions/gnutls_x509_crq_get_extension_by_oid

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_x509_crq_get_extension_by_oid} (gnutls_x509_crq_t @var{crq}, const char * @var{oid}, unsigned @var{indx}, void * @var{buf}, size_t * @var{buf_size}, unsigned int * @var{critical})
Packit aea12f
@var{crq}: should contain a @code{gnutls_x509_crq_t}  type
Packit aea12f
Packit aea12f
@var{oid}: holds an Object Identifier in a null terminated string
Packit aea12f
Packit aea12f
@var{indx}: In case multiple same OIDs exist in the extensions, this
Packit aea12f
specifies which to get. Use (0) to get the first one.
Packit aea12f
Packit aea12f
@var{buf}: a pointer to a structure to hold the name (may be null)
Packit aea12f
Packit aea12f
@var{buf_size}: initially holds the size of  @code{buf} 
Packit aea12f
Packit aea12f
@var{critical}: will be non-zero if the extension is marked as critical
Packit aea12f
Packit aea12f
This function will return the extension specified by the OID in
Packit aea12f
the certificate.  The extensions will be returned as binary data
Packit aea12f
DER encoded, in the provided buffer.
Packit aea12f
Packit aea12f
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit aea12f
negative error code in case of an error.  If the certificate does not
Packit aea12f
contain the specified extension
Packit aea12f
@code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will be returned.
Packit aea12f
Packit aea12f
@strong{Since:} 2.8.0
Packit aea12f
@end deftypefun