LmHandleMessageFunction ()

LmHandlerResult
(*LmHandleMessageFunction) (LmMessageHandler *handler,
                            LmConnection *connection,
                            LmMessage *message,
                            gpointer user_data);

The actual callback function in an LmMessageHandler. This function is called when an incoming message arrives that haven't been handled by an handler with higher priority.

lm_message_handler_new ()

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.

lm_message_handler_invalidate ()

void
lm_message_handler_invalidate (LmMessageHandler *handler);

Invalidates the handler. Useful if you need to cancel a reply

lm_message_handler_is_valid ()

gboolean
lm_message_handler_is_valid (LmMessageHandler *handler);

Fetches whether the handler is valid or not.

lm_message_handler_ref ()

LmMessageHandler *
lm_message_handler_ref (LmMessageHandler *handler);

Adds a reference to handler .

lm_message_handler_unref ()

void
lm_message_handler_unref (LmMessageHandler *handler);

Removes a reference from handler . When no more references are present the handler is freed.

LmMessageHandler

typedef struct LmMessageHandler LmMessageHandler;