get_most_available_presence


Description:

[ Version ( since = "0.9.0" ) ]
public ConnectionPresenceType get_most_available_presence (out string status, out string message)

Gets the most available presence over all accounts in this.

This function does not average presences across all accounts, but it merely finds the "most available" presence. As a result, there is a guarantee that there exists at least one account in this with the returned presence.

If no accounts are enabled or valid the output will be (%TP_CONNECTION_PRESENCE_TYPE_OFFLINE, "offline", "").

Since 0.17.5, if the only connected accounts does not implement IFACE_CONNECTION_INTERFACE_SIMPLE_PRESENCE, the output will be (%TP_CONNECTION_PRESENCE_TYPE_AVAILABLE, "available", "").

The return value of this function is not guaranteed to have been retrieved until prepare_async has finished; until then, the value will be the same as if no accounts are enabled or valid.

Parameters:

this

a AccountManager

status

a string to fill with the actual status

message

a string to fill with the actual status message

Returns:

the most available presence across all accounts