| Loudmouth Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
LmHandlerResult (*LmHandleMessageFunction) (LmMessageHandler *handler,LmConnection *connection,LmMessage *message,gpointer user_data); LmMessageHandler * lm_message_handler_new (LmHandleMessageFunction function,gpointer user_data,GDestroyNotify notify); void lm_message_handler_invalidate (LmMessageHandler *handler); gboolean lm_message_handler_is_valid (LmMessageHandler *handler); LmMessageHandler * lm_message_handler_ref (LmMessageHandler *handler); void lm_message_handler_unref (LmMessageHandler *handler);
LmHandlerResult (*LmHandleMessageFunction) (LmMessageHandler *handler,LmConnection *connection,LmMessage *message,gpointer user_data);
LmMessageHandler * lm_message_handler_new (LmHandleMessageFunction function,gpointer user_data,GDestroyNotify notify);
Creates a new message handler. This can be set to handle incoming messages
and when a message of the type the handler is registered to handle is
received function will be called and user_data will be passed to it.
notify is called when the message handler is freed, that way any memory
allocated by user_data can be freed.
|
a callback |
|
user data passed to function |
|
function called when the message handler is freed |
Returns : |
a newly created message handler |
void lm_message_handler_invalidate (LmMessageHandler *handler);
Invalidates the handler. Useful if you need to cancel a reply
|
an LmMessageHandler |
gboolean lm_message_handler_is_valid (LmMessageHandler *handler);
Fetches whether the handler is valid or not.
LmMessageHandler * lm_message_handler_ref (LmMessageHandler *handler);
Adds a reference to handler.
|
an LmMessageHandler |
Returns : |
the message handler |