DragonFly On-Line Manual Pages
gnutls_pkcs7_get_embedded_data(3) gnutls gnutls_pkcs7_get_embedded_data(3)
NAME
gnutls_pkcs7_get_embedded_data - API function
SYNOPSIS
#include <gnutls/pkcs7.h>
int gnutls_pkcs7_get_embedded_data(gnutls_pkcs7_t pkcs7, unsigned
flags, gnutls_datum_t * data);
ARGUMENTS
gnutls_pkcs7_t pkcs7
should contain a gnutls_pkcs7_t type
unsigned flags
must be zero or GNUTLS_PKCS7_EDATA_GET_RAW
gnutls_datum_t * data
will hold the embedded data in the provided structure
DESCRIPTION
This function will return the data embedded in the signature of the
PKCS7 structure. If no data are available then
GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.
The returned data must be de-allocated using gnutls_free().
Note, that this function returns the exact same data that are
authenticated. If the GNUTLS_PKCS7_EDATA_GET_RAW flag is provided, the
returned data will be including the wrapping tag/value as they are
encoded in the structure.
RETURNS
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative
error value.
SINCE
3.4.8
REPORTING BUGS
Report bugs to <bugs@gnutls.org>.
Home page: https://www.gnutls.org
COPYRIGHT
Copyright (C) 2001- Free Software Foundation, Inc., and others.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
SEE ALSO
The full documentation for gnutls is maintained as a Texinfo manual.
If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
form visit
https://www.gnutls.org/manual/
gnutls 3.7.9 gnutls_pkcs7_get_embedded_data(3)