1SSL_get_ex_data_X509_STORE_CTX_idx(3)OpenSSSLSL_get_ex_data_X509_STORE_CTX_idx(3)
2
3
4
6 SSL_get_ex_data_X509_STORE_CTX_idx - get ex_data index to access SSL
7 structure from X509_STORE_CTX
8
10 #include <openssl/ssl.h>
11
12 int SSL_get_ex_data_X509_STORE_CTX_idx(void);
13
15 SSL_get_ex_data_X509_STORE_CTX_idx() returns the index number under
16 which the pointer to the SSL object is stored into the X509_STORE_CTX
17 object.
18
20 Whenever a X509_STORE_CTX object is created for the verification of the
21 peers certificate during a handshake, a pointer to the SSL object is
22 stored into the X509_STORE_CTX object to identify the connection
23 affected. To retrieve this pointer the X509_STORE_CTX_get_ex_data()
24 function can be used with the correct index. This index is globally the
25 same for all X509_STORE_CTX objects and can be retrieved using
26 SSL_get_ex_data_X509_STORE_CTX_idx(). The index value is set when
27 SSL_get_ex_data_X509_STORE_CTX_idx() is first called either by the
28 application program directly or indirectly during other SSL setup
29 functions or during the handshake.
30
31 The value depends on other index values defined for X509_STORE_CTX
32 objects before the SSL index is created.
33
35 >=0 The index value to access the pointer.
36
37 <0 An error occurred, check the error stack for a detailed error
38 message.
39
41 The index returned from SSL_get_ex_data_X509_STORE_CTX_idx() allows to
42 access the SSL object for the connection to be accessed during the
43 verify_callback() when checking the peers certificate. Please check the
44 example in SSL_CTX_set_verify(3),
45
47 ssl(3), SSL_CTX_set_verify(3), CRYPTO_set_ex_data(3)
48
49
50
511.0.2o 2018-03-S2S7L_get_ex_data_X509_STORE_CTX_idx(3)