connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/interfaces/IClientServiceSiteUI2.java
--- a/connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/interfaces/IClientServiceSiteUI2.java Wed Dec 30 09:59:34 2009 -0600
+++ b/connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/interfaces/IClientServiceSiteUI2.java Wed Dec 30 11:43:43 2009 -0600
@@ -18,6 +18,7 @@
package com.nokia.carbide.remoteconnections.interfaces;
+import org.eclipse.core.runtime.IStatus;
import org.eclipse.swt.widgets.Composite;
/**
@@ -81,4 +82,21 @@
* @param listener IListener
*/
void removeListener(IListener listener);
+
+ /**
+ * Validate the selected connection and return a status.
+ * <p>
+ * @return IStatus for the state of the selection:
+ * <ol>
+ * <li>If a connection is selected and it's compatible, return OK.
+ * <li>If no connection is selected, return ERROR.
+ * <li>If selected connection is a default, but the current default is incompatible,
+ * return WARNING.
+ * (Normally, the concrete connections are already filtered to show only
+ * compatible ones, but the default may be anything.) This is only a warning
+ * because the default connection can be changed externally to this UI, thus
+ * isn't a fatal error.
+ * </ol>
+ */
+ IStatus getSelectionStatus();
}