--- version: v1.3.0 layout: manpage title: nng_http_client_set_tls(3http) ---
{% if page.version and page.version != site.latest %} {% if page.version == "tip" %} {% include manpage-tip.html %} {% else %} {% include manpage-old.html %} {% endif %} {% endif %}

SYNOPSIS

#include <nng/nng.h>
#include <nng/supplemental/http/http.h>

int nng_http_client_set_tls(nng_http_client *client, nng_tls_config *cfg);

DESCRIPTION

The nng_http_client_set_tls() sets the TLS configuration of client to cfg.

This change overwrites any previous TLS configuration.

This also invalidates any previously obtained values from nng_http_client_get_tls().
Any connections established with nng_http_client_connect() will continue to use any TLS configuration that they were started with.

RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

ERRORS

NNG_ENOMEM

Insufficient free memory exists.
NNG_ENOTSUP

Either HTTP or TLS not supported.

SEE ALSO

nng_http_client_alloc(3http), nng_http_client_connect(3http), nng_http_client_get_tls(3http), nng_tls_config_alloc(3tls), nng_strerror(3), nng(7)