Virtual Method

PurpleProtocolDirectorysearch_contacts_async

unstable since: 3.0

Declaration [src]

void
search_contacts_async (
  PurpleProtocolDirectory* protocol,
  PurpleAccount* account,
  const char* search_text,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer data
)

Description [src]

Searches the contacts directory of the protocol.

Protocols may return partial results immediately and continue updating the list.

Available since: 3.0

Parameters

account

Type: PurpleAccount

The account to search.

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

Type: const char*

The text to search.

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

Optional GCancellable object.

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

Type: GAsyncReadyCallback

A function to call when the search has results.

data

Type: gpointer

User data to pass to callback.

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