Constructor

PurpleFileTransfernew_receive

unstable since: 3.0

Declaration [src]

PurpleFileTransfer*
purple_file_transfer_new_receive (
  PurpleAccount* account,
  PurpleContactInfo* remote,
  const char* filename,
  guint64 file_size
)

Description [src]

Creates a new PurpleFileTransfer which will be used to negotiate a file transfer from remote to account with the given filename and file_size.

Note: This function should only be called by a protocol plugin implementation.

Available since: 3.0

Parameters

account

Type: PurpleAccount

The account this file transfer is to.

The data is owned by the caller of the function.

remote

Type: PurpleContactInfo

The PurpleContactInfo of the user sending the file.

The data is owned by the caller of the function.

filename

Type: const char*

The base filename.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

file_size

Type: guint64

The size of the file.

Return value

Type: PurpleFileTransfer

The new file transfer.

The caller of the function takes ownership of the data, and is responsible for freeing it.