connectivity/com.nokia.carbide.remoteConnections/src/com/nokia/carbide/remoteconnections/interfaces/IClientServiceSiteUI2.java
changeset 730 8ecd45ef360e
parent 728 a39d0ba41f81
child 759 d4aeef4e0f16
--- 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();
 }