Blame doc/functions/gnutls_ocsp_resp_get_extension

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_ocsp_resp_get_extension} (gnutls_ocsp_resp_t @var{resp}, unsigned @var{indx}, gnutls_datum_t * @var{oid}, unsigned int * @var{critical}, gnutls_datum_t * @var{data})
Packit aea12f
@var{resp}: should contain a @code{gnutls_ocsp_resp_t}  type
Packit aea12f
Packit aea12f
@var{indx}: Specifies which extension OID to get. Use (0) to get the first one.
Packit aea12f
Packit aea12f
@var{oid}: will hold newly allocated buffer with OID of extension, may be NULL
Packit aea12f
Packit aea12f
@var{critical}: output variable with critical flag, may be NULL.
Packit aea12f
Packit aea12f
@var{data}: will hold newly allocated buffer with extension data, may be NULL
Packit aea12f
Packit aea12f
This function will return all information about the requested
Packit aea12f
extension in the OCSP response.  The information returned is the
Packit aea12f
OID, the critical flag, and the data itself.  The extension OID
Packit aea12f
will be stored as a string.  Any of  @code{oid} ,  @code{critical} , and  @code{data} may
Packit aea12f
be NULL which means that the caller is not interested in getting
Packit aea12f
that information back.
Packit aea12f
Packit aea12f
The caller needs to deallocate memory by calling @code{gnutls_free()}  on
Packit aea12f
 @code{oid} ->data and  @code{data} ->data.
Packit aea12f
Packit aea12f
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit aea12f
negative error code is returned.  If you have reached the last
Packit aea12f
extension available @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will
Packit aea12f
be returned.
Packit aea12f
@end deftypefun