| Home | Libraries | People | FAQ | More

###### ssl_stream::async_handshake (1 of 2 overloads)

Start an asynchronous SSL handshake.

<h7> Synopsis </h7>

    template<
        class HandshakeHandler>
    DEDUCED
    async_handshake(
        handshake_type type,
        BOOST_ASIO_MOVE_ARG(HandshakeHandler) handler);

<h7> Description </h7>

This function is used to asynchronously perform an SSL handshake on the stream. This function call always returns immediately.

<h7> Parameters </h7>

Name | Description
--- | ---
`type` | The type of handshaking to be performed, i.e. as a client or as a server.

`handler`

The handler to be called when the handshake operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be:

     void handler(
      const boost::system::error_code& error // Result of operation.
    );