ensure_channel
Description:
Returns a Channel proxy for the channel at object_path
on
connection
.
The returned Channel is cached; the same Channel object will be returned by this function repeatedly, as long as at least one reference exists.
Note that the returned Channel is not guaranteed to be ready; the caller is responsible for calling prepare_async with the desired features (as given by dup_channel_features).
This function is rather low-level. AccountChannelRequest and BaseClient are more appropriate ways to obtain channels for most applications.
Parameters:
this |
a SimpleClientFactory object |
connection |
a Connection whose factory is this object |
object_path |
the object path of a channel on |
immutable_properties |
the immutable properties of the channel |
Returns:
a reference to a Channel; see Channel.from_properties. |