Update src/main/java/com/microsoft/sqlserver/jdbc/ISQLServerDataSourc…

…e.java Co-authored-by: David Engel <v-davidengel@microsoft.com>
microsoft · Nov 15, 2023 · ef0869e · ef0869e
1 parent d41e1f8
commit ef0869e
Showing 1 changed file with 5 additions and 2 deletions.
diff --git a/src/main/java/com/microsoft/sqlserver/jdbc/ISQLServerDataSource.java b/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);