Function SilcClientConnectCallback
SYNOPSIS
void (*SilcClientConnectCallback)(SilcClient client,
SilcClientConnection conn,
SilcClientConnectionStatus status,
SilcStatus error,
const char *message,
void *context);
DESCRIPTION
Connect callbak given as argument to silc_client_connect_to_server,
silc_client_connect_to_client and silc_client_key_exchange functions.
It is called to indicate the status of the connection, indicated
by the `status'. It is called after the connection has been
established to the remote host and when connection is disconnected
by the remote host. The `context' is the context given as argument
to the connecting function. If the `status' is an error the `error'
may indicate more detailed error. If `error' is SILC_STATUS_OK no
detailed error message is available.
When the `status' is SILC_CLIENT_CONN_DISCONNECTED the `error' will
indicate the reason for disconnection. If the `message' is non-NULL
it delivers error or disconnection message.
The `conn' is the connection to the remote host. In case error
occurred the `conn' may be NULL, however, in some cases a valid `conn'
is returned even in error. If `conn' is non-NULL the receiver is
responsible of closing the connection with silc_client_close_connection
function, except when SILC_CLINET_CONN_DISCONNECTED or some error
was received. In these cases the library will close the connection.
|