Log: controller: improve messages for remote executor connection failure

Use the new lrmd__new() constructor when connecting from the controller to a
remote executor, so we can give a more detailed log message on failures.

This also uses standard Pacemaker return codes in the affected functions,
and renames lrm_state_remote_connect_async() to
controld_connect_remote_executor() to follow current naming guidelines.