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

NAME

nng_http_handler_set_data - set extra data for HTTP handler

SYNOPSIS

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

int nng_http_handler_set_data(nng_http_handler *handler, void *data,
    void (*dtor)(void *));

DESCRIPTION

The nng_http_handler_set_data() function is used to set an additional data for the handler. The stored data can be retrieved later in the handler function using nng_http_handler_get_data().

Additionally, when the handler is deallocated, if dtor is not NULL, then it will be called with data as its argument. The intended use of this function is deallocate any resources associated with data.

RETURN VALUES

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

ERRORS

`NNG_ENOMEM`	Insufficient free memory to perform the operation.
`NNG_ENOTSUP`	No support for HTTP in the library.