handle_with_async


Description:

[ Version ( since = "0.11.5" ) ]
public async bool handle_with_async (string? handler) throws Error

Called by an approver to accept a channel bundle and request that the given handler be used to handle it.

If successful, this method will cause the invalidated signal to be emitted with the TP_DBUS_ERROR_OBJECT_REMOVED error code.

However, this method may fail because the dispatch has already been completed and the object has already gone. If this occurs, it indicates that another approver has asked for the bundle to be handled by a particular handler. The approver MUST NOT attempt to interact with the channels further in this case, unless it is separately invoked as the handler.

Approvers which are also channel handlers SHOULD use claim_async instead of handle_with_async to request that they can handle a channel bundle themselves.

Parameters:

this

a ChannelDispatchOperation

handler

The well-known bus name (starting with CLIENT_BUS_NAME_BASE) of the channel handler that should handle the channel, or null if the client has no preferred channel handler

callback

a callback to call when the call returns

user_data

data to pass to callback