Signal

PurpleXfer::query-local

since: 3.0.0

Declaration

gboolean
query_local (
  PurpleXfer* self,
  gchar* filename,
  gpointer user_data
)

Description [src]

Query a file’s properties locally.

The default class handler will query a file using standard library functions, and set the transfer’s size. If you connect to this signal, you should try to do the same, but it is not necessarily an error if you cannot. If you connect to this signal, you must connect to PurpleXfer::open-local, PurpleXfer::read-local, PurpleXfer::write-local and PurpleXfer::data-not-sent as well.

Default handler:

The default handler is called after the handlers added via g_signal_connect().

Available since: 3.0.0

Parameters

filename

Type: gchar*

The filename of the transfer.

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 properties were queried successfully, or FALSE otherwise, and the transfer should be cancelled (libpurple will cancel).