Method

PurpleProtocolContactsset_alias_async

unstable since: 3.0

Declaration [src]

void
purple_protocol_contacts_set_alias_async (
  PurpleProtocolContacts* protocol,
  PurpleContact* contact,
  const char* alias,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Starts the process of setting an alias on a contact.

Call purple_protocol_contacts_set_alias_finish() from the callback to get the results.

Available since: 3.0

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

Parameters

contact

Type: PurpleContact

The contact whose alias to set.

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

Type: const char*

The new alias.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
cancellable

Type: GCancellable

An optional GCancellable.

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

Type: GAsyncReadyCallback

A callback to call when the request is complete.

The argument can be NULL.
data

Type: gpointer

User data to pass to the callback.

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