Update src/main/java/com/microsoft/sqlserver/jdbc/ISQLServerDataSource.java

Co-authored-by: David Engel <[email protected]>

Author: tkyc

src/main/java/com/microsoft/sqlserver/jdbc/ISQLServerDataSource.java

@@ -613,8 +613,11 @@ public interface ISQLServerDataSource extends javax.sql.CommonDataSource {
      * Sets whether or not sp_sproc_columns will be used for parameter name lookup.
      *
      * @param useFlexibleCallableStatements
-     *        When set to true, sp_sproc_columns is not used for parameter name lookup
-     *        in callable statements.
+     *        When set to false, sp_sproc_columns is not used for parameter name lookup
+     *        in callable statements. This eliminates a round trip to the server but imposes limitations
+     *        on how parameters are set. When set to false, applications must either reference
+     *        parameters by name or by index, not both. Parameters must also be set in the same
+     *        order as the stored procedure definition.
      */
     void setUseFlexibleCallableStatements(boolean useFlexibleCallableStatements);