Gio.SocketClient.set_tls

### Method

# Gio SocketClientset_tls

since: 2.28

#### Declaration [src]

    void
    g_socket_client_set_tls (
      GSocketClient* client,
      gboolean tls
    )

#### Description [src]

Sets whether `client` creates TLS (aka SSL) connections. If `tls` is `TRUE`, `client` will wrap its connections in a `GTlsClientConnection` and perform a TLS handshake when connecting.

Note that since `GSocketClient` must return a `GSocketConnection`, but `GTlsClientConnection` is not a `GSocketConnection`, this actually wraps the resulting `GTlsClientConnection` in a `GTcpWrapperConnection` when returning it. You can use `g_tcp_wrapper_connection_get_base_io_stream()` on the return value to extract the `GTlsClientConnection`.

If you need to modify the behavior of the TLS handshake (eg, by setting a client-side certificate to use, or connecting to the `GTlsConnection::accept-certificate` signal), you can connect to `client`‘s `GSocketClient::event` signal and wait for it to be emitted with `G_SOCKET_CLIENT_TLS_HANDSHAKING`, which will give you a chance to see the `GTlsClientConnection` before the handshake starts.

Available since: 2.28

Sets property | `Gio.SocketClient:tls`

#### Parameters

`tls`

  Type: `gboolean`

  Whether to use TLS.