Blame doc/functions/gnutls_pkcs7_get_embedded_data

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