This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.8.0. See the documentation for v1.8.0 for the most up-to-date information.

nng_http_client_set_tls(3http)

NAME

nng_http_client_set_tls - set HTTP client TLS configuration

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.