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_get_tls(3http)

NAME

nng_http_client_get_tls - get HTTP client TLS configuration

SYNOPSIS

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

int nng_http_client_get_tls(nng_http_client *client, nng_tls_config **cfgp);

DESCRIPTION

The nng_http_client_get_tls() obtains the TLS configuration of client and saves a pointer to it in the address referenced by cfgp.

The object will be returned with an extra hold (see nng_tls_config_hold()) placed on it on behalf of the caller. The caller should free this hold by calling nng_tls_config_free() with it is done with the TLS configuration.

RETURN VALUES

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

ERRORS

`NNG_EINVAL`	TLS not configured on client.
`NNG_ENOMEM`	Insufficient free memory exists.
`NNG_ENOTSUP`	Either HTTP or TLS not supported.