called to save the user-entered options to the connection object.
Should return false and set throws if the current options are invalid. throws should contain enough information for the plugin to determine which UI widget is invalid at a later point in time. For example, creating unique error codes for what error occurred and populating the message field of throws with the name of the invalid property.