參數繫結位移

應用程式在呼叫 SQLExecDirectSQLExecute 時,可指定在繫結參數緩衝區位址與對應的長度/指示器緩衝區位址上新增位移。 此新增結果會決定這些作業中所使用的位址。

繫結位移可讓應用程式變更繫結,不需針對先前繫結的參數呼叫 SQLBindParameter。 呼叫 SQLBindParameter 以重新繫結參數會變更緩衝區位址與長度/指示器指標。 另一方面,利用位移來重新繫結,僅會在現有的繫結參數緩衝區位址與長度/指示器緩衝區位址上增加位移。 當採用位移時,繫結是應用程式緩衝區配置方式的「範本」,應用程式可透過變更位移來移動此「範本」至記憶體的不同區域。 新的位移可以在任何時候指定,且一律會加入原始的繫結值中。

若要指定繫結位移,應用程式會將 SQL_ATTR_PARAM_BIND_OFFSET_PTR 陳述式屬性設為 SQLINTEGER 緩衝區的位址。 在應用程式呼叫使用繫結的函式之前,只要參數緩衝區位址或長度/指示器緩衝區位址均非 0,且繫結參數位於 SQL 陳述式中,就會在該緩衝區中以位元組為單位放置位移。 位址與位移的總和必須是有效的位址。 (這表示,只要位移總和是有效位址,則位移與要新增該位移的位址其中之一或兩者均可為無效。)

注意

ODBC 2 x 驅動程式不支援繫結位移。