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
|