Method
PurpleProtocolDirectorysearch_contacts_async
unstable since: 3.0
Declaration [src]
void
purple_protocol_directory_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
This method completes asynchronously. Use purple_protocol_directory_search_contacts_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
account-
Type:
PurpleAccountThe 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:
GCancellableOptional GCancellable object.
The argument can be NULL.The data is owned by the caller of the method. callback-
Type:
GAsyncReadyCallbackA function to call when the search has results.
The argument can be NULL. data-
Type:
gpointerUser data to pass to
callback.The argument can be NULL.The data is owned by the caller of the method.