Function

Purpleserv_chat_send

Declaration [src]

int
purple_serv_chat_send (
  PurpleConnection* gc,
  int id,
  PurpleMessage* msg
)

Description [src]

Send a message to a chat.

This protocol function should return a positive value on success. If the message is too big to be sent, return -E2BIG. If the account is not connected, return -ENOTCONN. If the protocol is unable to send the message for another reason, return some other negative value. You can use one of the valid #errno values, or just big something.

Parameters

gc

Type: PurpleConnection

The connection over which to send the typing notification.

The data is owned by the caller of the function.

id

Type: int

The id of the chat to send the message to.

msg

Type: PurpleMessage

The message to send to the chat.

The data is owned by the caller of the function.

Return value

Type: int

A positive number or 0 in case of success, a negative error number in case of failure.