Function silc_client_private_message_wait
SYNOPSIS
SilcBool
silc_client_private_message_wait(SilcClient client,
SilcClientConnection conn,
SilcClientEntry client_entry,
SilcMessagePayload *payload);
DESCRIPTION
Blocks current thread or process until a private message has been
received from the remote client indicated by `client_entry'. Before
private messages can be waited the silc_client_private_message_wait_init
must be called. This function can be used from a thread to wait for
private message from the specified client. Multiple threads can be
created to wait messages from multiple clients. Any other private
message received from the connection indicated by `conn' will be
forwarded to the normal `private_message' client operation callback.
The private messages from `client_entry' will not be delivered to the
`private_message' client operation callback.
Returns TRUE and the received private message into `payload'. The caller
must free the returned SilcMessagePayload. If this function returns
FALSE the private messages cannot be waited anymore. This happens
when some other thread calls silc_client_private_message_wait_uninit.
This returns FALSE also if silc_client_private_message_wait_init has
not been called.
|