SSLSocket.StartHandshake Method

Definition

Starts an SSL handshake on this connection.

[Android.Runtime.Register("startHandshake", "()V", "GetStartHandshakeHandler")]
public abstract void StartHandshake ();
[<Android.Runtime.Register("startHandshake", "()V", "GetStartHandshakeHandler")>]
abstract member StartHandshake : unit -> unit
Attributes

Exceptions

if an error occurs.

Remarks

Starts an SSL handshake on this connection. Common reasons include a need to use new encryption keys, to change cipher suites, or to initiate a new session. To force complete reauthentication, the current session could be invalidated before starting this handshake.

If data has already been sent on the connection, it continues to flow during this handshake. When the handshake completes, this will be signaled with an event.

This method is synchronous for the initial handshake on a connection and returns when the negotiated handshake is complete. Some protocols may not support multiple handshakes on an existing socket and may throw an IOException.

Java documentation for javax.net.ssl.SSLSocket.startHandshake().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to