Blame doc/functions/gnutls_pkcs7_get_embedded_data

Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
Packit aea12f
@deftypefun {int} {gnutls_pkcs7_get_embedded_data} (gnutls_pkcs7_t @var{pkcs7}, unsigned @var{flags}, gnutls_datum_t * @var{data})
Packit aea12f
@var{pkcs7}: should contain a gnutls_pkcs7_t type
Packit aea12f
Packit aea12f
@var{flags}: must be zero or @code{GNUTLS_PKCS7_EDATA_GET_RAW} 
Packit aea12f
Packit aea12f
@var{data}: will hold the embedded data in the provided structure
Packit aea12f
Packit aea12f
This function will return the data embedded in the signature of
Packit aea12f
the PKCS7 structure. If no data are available then
Packit aea12f
@code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will be returned.
Packit aea12f
Packit aea12f
The returned data must be de-allocated using @code{gnutls_free()} .
Packit aea12f
Packit aea12f
Note, that this function returns the exact same data that are
Packit aea12f
authenticated. If the @code{GNUTLS_PKCS7_EDATA_GET_RAW}  flag is provided,
Packit aea12f
the returned data will be including the wrapping tag/value as
Packit aea12f
they are encoded in the structure.
Packit aea12f
Packit aea12f
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit aea12f
negative error value.
Packit aea12f
Packit aea12f
@strong{Since:} 3.4.8
Packit aea12f
@end deftypefun