set a TLS/SSL session to be used during TLS/SSL
to be used when the TLS/SSL
connection is to be established.
() is only useful for TLS/SSL
clients. When the session is set, the reference count of
is incremented by 1. If the session
is not reused, the reference count is decremented again during
(). Whether the session was reused can
be queried with the
If there is already a session set inside ssl
(because it was set with SSL_set_session
or because the same ssl
was already used for
will be called for that session.
objects keep internal link
information about the session cache list when being inserted into one
object's session cache. One
object, regardless of its
reference count, must therefore only be used with one
object (and the
objects created from this
The following return values can occur:
- The operation failed; check the error stack to find out the
- The operation succeeded.