summaryrefslogtreecommitdiffstats
path: root/doc/functions/gnutls_x509_crt_get_tlsfeatures
blob: f037e08409fa637b3658db30f73135bd16e2703c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
@deftypefun {int} {gnutls_x509_crt_get_tlsfeatures} (gnutls_x509_crt_t @var{crt}, gnutls_x509_tlsfeatures_t @var{features}, unsigned int @var{flags}, unsigned int * @var{critical})
@var{crt}: A X.509 certificate

@var{features}: If the function succeeds, the
features will be stored in this variable.

@var{flags}: zero or @code{GNUTLS_EXT_FLAG_APPEND} 

@var{critical}: the extension status

This function will get the X.509 TLS features
extension structure from the certificate. The
returned structure needs to be freed using
@code{gnutls_x509_tlsfeatures_deinit()} .

When the  @code{flags} is set to @code{GNUTLS_EXT_FLAG_APPEND} ,
then if the  @code{features} structure is empty this function will behave
identically as if the flag was not set. Otherwise if there are elements 
in the  @code{features} structure then they will be merged with.

Note that  @code{features} must be initialized prior to calling this function.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
otherwise a negative error value.

@strong{Since:} 3.5.1
@end deftypefun