pub unsafe extern "C" fn dxf_create_connection(
    address: *const c_char,
    notifier: dxf_conn_termination_notifier_t,
    conn_status_notifier: dxf_conn_status_notifier_t,
    stcn: dxf_socket_thread_creation_notifier_t,
    stdn: dxf_socket_thread_destruction_notifier_t,
    user_data: *mut c_void,
    connection: *mut dxf_connection_t
) -> ERRORCODE
Expand description

@ingroup c-api-connection-functions

@brief Creates connection with the specified parameters.

@details

@param[in] address Connection string - the single address: host:port or just host - address with credentials: host:port[username=xxx,password=yyy] - multiple addresses: (host1:port1)(host2)(host3:port3[username=xxx,password=yyy]) - the data from file: /path/to/file on *nix and drive:\path\to\file on Windows @param[in] notifier The callback to inform the client side that the connection has stumbled upon and error and will go reconnecting @param[in] conn_status_notifier The callback to inform the client side that the connection status has changed @param[in] stcn The callback for informing the client side about the socket thread creation; may be set to NULL if no specific action is required to perform on the client side on a new thread creation @param[in] stdn The callback for informing the client side about the socket thread destruction; may be set to NULL if no specific action is required to perform on the client side on a thread destruction @param[in] user_data The user defined value passed to the termination notifier callback along with the connection handle; may be set to whatever value @param[out] connection The handle of the created connection

@return DXF_SUCCESS on successful connection establishment or DXF_FAILURE on error. Created connection is returned via OUT parameter connection. {@link dxf_get_last_error} can be used to retrieve the error code and description in case of failure.