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.7.3. See the documentation for v1.7.3 for the most up-to-date information.

nng_stream_dialer_dial(3str)

NAME

nng_stream_dialer_dial - initiate outgoing byte stream connection

SYNOPSIS

#include <nng/nng.h>

void nng_stream_dialer_dial(nng_stream_dialer *d, nng_aio *aio);

DESCRIPTION

The nng_stream_dialer_dial() attempts to establish a connection to the remote peer for the dialer d. The operation is completed asynchronously, using aio.

The peer address is determined by the address specified using nng_stream_dialer_alloc() or nng_stream_dialer_alloc_url().

If a connection is successfully established, the aio will have the resulting nng_stream object stored as its first output. (See nng_aio_get_output().)

RETURN VALUES

None.

ERRORS

NNG_EADDRINVAL

The address specified is invalid.

NNG_ECANCELED

The operation was aborted.

NNG_ECLOSED

The dialer is closed.

NNG_ECONNREFUSED

The connection was refused by the server.

NNG_ECONNRESET

The connection was reset by the server.

NNG_ENOMEM

Insufficient free memory exists.

SEE ALSO