Blame doc/functions/gnutls_x509_crq_get_extension_info

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_x509_crq_get_extension_info} (gnutls_x509_crq_t @var{crq}, unsigned @var{indx}, void * @var{oid}, size_t * @var{sizeof_oid}, unsigned int * @var{critical})
Packit aea12f
@var{crq}: should contain a @code{gnutls_x509_crq_t}  type
Packit aea12f
Packit aea12f
@var{indx}: Specifies which extension number to get. Use (0) to get the first one.
Packit aea12f
Packit aea12f
@var{oid}: a pointer to store the OID
Packit aea12f
Packit aea12f
@var{sizeof_oid}: initially holds the maximum size of  @code{oid} , on return
Packit aea12f
holds actual size of  @code{oid} .
Packit aea12f
Packit aea12f
@var{critical}: output variable with critical flag, may be NULL.
Packit aea12f
Packit aea12f
This function will return the requested extension OID in the
Packit aea12f
certificate, and the critical flag for it.  The extension OID will
Packit aea12f
be stored as a string in the provided buffer.  Use
Packit aea12f
@code{gnutls_x509_crq_get_extension_data()}  to extract the data.
Packit aea12f
Packit aea12f
If the buffer provided is not long enough to hold the output, then
Packit aea12f
* @code{sizeof_oid} is updated and @code{GNUTLS_E_SHORT_MEMORY_BUFFER}  will be
Packit aea12f
returned.
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 your have reached the
Packit aea12f
last extension available @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} 
Packit aea12f
will be returned.
Packit aea12f
Packit aea12f
@strong{Since:} 2.8.0
Packit aea12f
@end deftypefun