Method

PurpleProtocolRosterupdate_async

unstable since: 3.0

Declaration [src]

void
purple_protocol_roster_update_async (
  PurpleProtocolRoster* roster,
  PurpleAccount* account,
  PurpleContact* contact,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Requests that roster updates contact on the server side roster. When callback is called, purple_protocol_roster_update_finish() should be called to get the result.

This would include things that the libpurple user can change about a remote contact. Including but not limited to PurpleContactInfo:alias, PurpleContactInfo:permission, PurpleContactInfo:person, and PurpleContactInfo:tags.

Available since: 3.0

This method completes asynchronously. Use purple_protocol_roster_update_finish() inside the GAsyncReadyCallback to obtain the result of the operation.

Parameters

account

Type: PurpleAccount

The PurpleAccount to use.

The data is owned by the caller of the method.
contact

Type: PurpleContact

The PurpleContact to update.

The data is owned by the caller of the method.
cancellable

Type: GCancellable

A GCancellable.

The argument can be NULL.
The data is owned by the caller of the method.
callback

Type: GAsyncReadyCallback

A GAsyncReadyCallback to call when the request has completed.

The argument can be NULL.
data

Type: gpointer

User data to pass to callback.

The argument can be NULL.
The data is owned by the caller of the method.