ensure_channel_async

Description:

public async bool ensure_channel_async (string preferred_handler, Cancellable? cancellable) throws Error

Asynchronously calls EnsureChannel on the ChannelDispatcher to create a channel with the properties defined in TpAccountChannelRequest:request and let the ChannelDispatcher dispatch it to an handler.

If a suitable channel already existed, its handler will be notified that the channel was requested again (for instance with re_handled, BaseClientClassHandleChannelsImpl or callback, if it is implemented using Telepathy-GLib), so that it can re-present the window to the user, for example. Otherwise, a new channel will be created and dispatched to a handler.

callback will be called when an existing channel's handler has been notified, a new channel has been created and dispatched, or the request has failed. You can then call ensure_channel_async.end to get the result of the operation.

Parameters:

this	a AccountChannelRequest
preferred_handler	Either the well-known bus name (starting with CLIENT_BUS_NAME_BASE) of the preferred handler for the channel, or `null` to indicate that any handler would be acceptable.
cancellable	optional Cancellable object, `null` to ignore
callback	a callback to call when the request is satisfied
user_data	data to pass to `callback`