SQLSetScrollOptions 對應

  • 發行項

當應用程式透過 ODBC 3.x 驅動程式呼叫 SQLSetScrollOptions 且驅動程式不支援 SQLSetScrollOptions 時，呼叫

SQLSetScrollOptions(StatementHandle, Concurrency, KeysetSize, RowsetSize)

將會產生下列結果：

  • 對 的呼叫

    SQLGetInfo(ConnectionHandle, InfoType, InfoValuePtr, BufferLength, StringLengthPtr)

    InfoType 引數設定為下表中的其中一個值，視 SQLSetScrollOptions 中的 KeysetSize 引數值 而定。

    KeysetSize 引數 InfoType 引數
    SQL_SCROLL_FORWARD_ONLY SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2
    SQL_SCROLL_STATIC SQL_STATIC_CURSOR_ATTRIBUTES2
    SQL_SCROLL_KEYSET_DRIVEN SQL_KEYSET_CURSOR_ATTRIBUTES2
    SQL_SCROLL_DYNAMIC SQL_DYNAMIC_CURSOR_ATTRIBUTES2
    大於 RowsetSize 引數的值 SQL_KEYSET_CURSOR_ATTRIBUTES2

    如果上表未列出 KeysetSize 引數的值 ，則對 SQLSetScrollOptions 的呼叫 會傳回 SQLSTATE S1107 （超出範圍的資料列值），而且不會執行下列步驟。

    然後，驅動程式管理員會根據 SQLSetScrollOptions 中並行引數的值 ，驗證呼叫 SQLGetInfo 所 傳回的 * InfoValuePtr 值中是否設定適當的 位。

    並行自 變數 InfoType 設定
    SQL_CONCUR_READ_ONLY SQL_CA2_READ_ONLY_CONCURRENCY
    SQL_CONCUR_LOCK SQL_CA2_LOCK_CONCURRENCY
    SQL_CONCUR_ROWVER SQL_CA2_ROWVER_CONCURRENCY
    SQL_CONCUR_VALUES SQL_CA2_VALUES_CONCURRENCY

    如果並行自 變數不是上表中的其中一個值，則對 SQLSetScrollOptions 的呼叫 會傳回 SQLSTATE S1108 （超出範圍的並行選項），而且不會執行下列步驟。 如果 * InfoValuePtr 中未將適當的位 （如上表所示） 設定為對應 至 Concurrency 引數的其中一個值，則對 SQLSetScrollOptions 的呼叫 會傳回 SQLSTATE S1C00 （驅動程式無法執行），而且不會執行下列步驟。

  • 對 的呼叫

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CURSOR_TYPE, ValuePtr, 0)

    根據 SQLSetScrollOptions 中 KeysetSize 引數的值，將 *ValuePtr 設定為下表中的 其中一個值 。

    KeysetSize 引數 *ValuePtr
    SQL_SCROLL_FORWARD_ONLY SQL_CURSOR_FORWARD_ONLY
    SQL_SCROLL_STATIC SQL_CURSOR_STATIC
    SQL_SCROLL_KEYSET_DRIVEN SQL_CURSOR_KEYSET_DRIVEN
    SQL_SCROLL_DYNAMIC SQL_CURSOR_DYNAMIC
    大於 RowsetSize 引數的值 SQL_CURSOR_KEYSET_DRIVEN

  • 對 的呼叫

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CONCURRENCY, ValuePtr, 0)

    將 *ValuePtr 設定為 SQLSetScrollOptions 中的 並行 引數。

  • 如果對 SQLSetScrollOptions 呼叫 中的 KeysetSize 引數為正數，則呼叫

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_KEYSET_SIZE, ValuePtr, 0)

    將 *ValuePtr 設定為 SQLSetScrollOptions 中的 KeysetSize 引數。

  • 對 的呼叫

    SQLSetStmtAttr(StatementHandle, SQL_ROWSET_SIZE, ValuePtr, 0)

    將 *ValuePtr 設定為 SQLSetScrollOptions 中的 RowsetSize 引數。

    注意

    當 Driver Manager 將 SQLSetScrollOptions 對應給使用不支援 SQLSetScrollOptions 之 ODBC 3.x 驅動程式的應用程式時，Driver Manager 會將 SQL_ROWSET_SIZE 語句選項，而不是 SQL_ATTR_ROW_ARRAY_SIZE 語句屬性，設定為 SQLSetScrollOption 中的 RowsetSize 引數。 因此，呼叫 SQLFetch 或 SQLFetchScroll 時 ， 應用程式無法使用 SQLSetScrollOptions 。 只有當呼叫 SQLExtendedFetch 擷取多個資料列時，才能使用它。