gnutls_pkcs7_get_embedded_data(3)

1gnutls_pkcs7_get_embedded_data(3)   gnutls   gnutls_pkcs7_get_embedded_data(3)
2
3
4

NAME

6       gnutls_pkcs7_get_embedded_data - API function
7

SYNOPSIS

9       #include <gnutls/pkcs7.h>
10
11       int   gnutls_pkcs7_get_embedded_data(gnutls_pkcs7_t   pkcs7,   unsigned
12       flags, gnutls_datum_t * data);
13

ARGUMENTS

15       gnutls_pkcs7_t pkcs7
16                   should contain a gnutls_pkcs7_t type
17
18       unsigned flags
19                   must be zero or GNUTLS_PKCS7_EDATA_GET_RAW
20
21       gnutls_datum_t * data
22                   will hold the embedded data in the provided structure
23

DESCRIPTION

25       This function will return the data embedded in  the  signature  of  the
26       PKCS7     structure.     If     no     data    are    available    then
27       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.
28
29       The returned data must be de-allocated using gnutls_free().
30
31       Note, that this function returns the exact same data that are authenti‐
32       cated. If the GNUTLS_PKCS7_EDATA_GET_RAW flag is provided, the returned
33       data will be including the wrapping tag/value as they  are  encoded  in
34       the structure.
35

RETURNS

37       On  success,  GNUTLS_E_SUCCESS  [22m(0)  is  returned, otherwise a negative
38       error value.
39

SINCE

41       3.4.8
42

REPORTING BUGS

44       Report bugs to <bugs@gnutls.org>.
45       Home page: http://www.gnutls.org
46
47

COPYRIGHT

49       Copyright © 2001-2018 Free Software Foundation, Inc., and others.
50       Copying and distribution of this file, with  or  without  modification,
51       are  permitted  in  any  medium  without royalty provided the copyright
52       notice and this notice are preserved.
53