ensure_channel


Description:

public Channel ensure_channel (Connection connection, string object_path, HashTable<string,Value?> immutable_properties) throws Error

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 connection

immutable_properties

the immutable properties of the channel

Returns:

a reference to a Channel; see Channel.from_properties.