ensure_account


Description:

public Account ensure_account (string object_path, HashTable<string,Value?> immutable_properties) throws Error

Returns a Account proxy for the account at object_path.

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

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

This function is rather low-level. dup_valid_accounts and TpAccountManager::validity-changed are more appropriate for most applications.

Parameters:

this

a SimpleClientFactory object

object_path

the object path of an account

immutable_properties

the immutable properties of the account, or null.

Returns:

a reference to a Account; see Account.