2 nghttp2_submit_settings
3 =======================
8 *#include <nghttp2/nghttp2.h>*
10 .. function:: int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags, const nghttp2_settings_entry *iv, size_t niv)
13 Stores local settings and submits SETTINGS frame. The *iv* is the
14 pointer to the array of :type:`nghttp2_settings_entry`. The *niv*
15 indicates the number of :type:`nghttp2_settings_entry`.
17 The *flags* is currently ignored and should be
18 :macro:`NGHTTP2_FLAG_NONE`.
20 This function does not take ownership of the *iv*. This function
21 copies all the elements in the *iv*.
23 While updating individual stream's local window size, if the window
24 size becomes strictly larger than NGHTTP2_MAX_WINDOW_SIZE,
25 RST_STREAM is issued against such a stream.
27 SETTINGS with :macro:`NGHTTP2_FLAG_ACK` is automatically submitted
28 by the library and application could not send it at its will.
30 This function returns 0 if it succeeds, or one of the following
33 :macro:`NGHTTP2_ERR_INVALID_ARGUMENT`
34 The *iv* contains invalid value (e.g., initial window size
35 strictly greater than (1 << 31) - 1.
36 :macro:`NGHTTP2_ERR_NOMEM`