Function

PurpleConversationpresent_error

since: 3.0

Declaration [src]

gboolean
purple_conversation_present_error (
  const char* who,
  PurpleAccount* account,
  const char* what
)

Description [src]

Presents an IM-error to the user

This is a helper function to find a conversation, write an error to it, and raise the window. If a conversation with this user doesn’t already exist, the function will return FALSE and the calling function can attempt to present the error another way (purple_notify_error, most likely)

Available since: 3.0

Parameters

who

Type: const char*

The user this error is about.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
account

Type: PurpleAccount

The account this error is on.

The data is owned by the caller of the function.
what

Type: const char*

The error.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: gboolean

TRUE if the error was presented, else FALSE.