ensure_connection


Description:

public Connection ensure_connection (string object_path, HashTable<string,Value?> immutable_properties) throws Error

Returns a Connection proxy for the connection at object_path .

The returned Connection is cached; the same Connection object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned Connection is not guaranteed to be ready; the caller is responsible for calling prepare_async with the desired features (as given by dup_connection_features).

This function is rather low-level. connection is more appropriate for most applications.

Parameters:

this

a SimpleClientFactory object

object_path

the object path of a connection

immutable_properties

the immutable properties of the connection.

Returns:

a reference to a Connection; see Connection.