Blame doc/functions/gnutls_ocsp_req_get_extension

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