Asignación de SQLSetScrollOptions

  • Artículo

Cuando una aplicación llama a SQLSetScrollOptions a través de un controlador ODBC 3.x y el controlador no admite SQLSetScrollOptions, la llamada a

SQLSetScrollOptions(StatementHandle, Concurrency, KeysetSize, RowsetSize)

dará como resultado lo siguiente:

  • Una llamada a 

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

    con el argumento InfoType establecido en uno de los valores de la tabla siguiente, según el valor del argumento KeysetSize en SQLSetScrollOptions.

    Argumento KeysetSize Argumento 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
    Valor mayor que el argumento RowsetSize SQL_KEYSET_CURSOR_ATTRIBUTES2

    Si el valor del argumento KeysetSize no aparece en la tabla anterior, la llamada a SQLSetScrollOptions devuelve SQLSTATE S1107 (valor de fila fuera del intervalo) y no se realiza ninguno de los pasos siguientes.

    A continuación, el Administrador de controladores comprueba si el bit adecuado se establece en el valor *InfoValuePtr devuelto por la llamada a SQLGetInfo, según el valor del argumento Concurrency en SQLSetScrollOptions.

    Argumento de simultaneidad Configuración de 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

    Si el argumento Concurrency no es uno de los valores de la tabla anterior, la llamada a SQLSetScrollOptions devuelve SQLSTATE S1108 (opción de simultaneidad fuera del intervalo) y ninguno de los pasos siguientes se realiza. Si el bit adecuado (como se indica en la tabla anterior) no se establece en *InfoValuePtr en uno de los valores correspondientes al argumento Concurrency , la llamada a SQLSetScrollOptions devuelve SQLSTATE S1C00 (controlador no compatible) y ninguno de los pasos siguientes se realiza.

  • Una llamada a 

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CURSOR_TYPE, ValuePtr, 0)

    con *ValuePtr establecido en uno de los valores de la tabla siguiente, según el valor del argumento KeysetSize en SQLSetScrollOptions.

    Argumento 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
    Valor mayor que el argumento RowsetSize SQL_CURSOR_KEYSET_DRIVEN

  • Una llamada a 

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CONCURRENCY, ValuePtr, 0)

    con *ValuePtr establecido en el argumento Concurrency en SQLSetScrollOptions.

  • Si el argumento KeysetSize de la llamada a SQLSetScrollOptions es positivo, una llamada a

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_KEYSET_SIZE, ValuePtr, 0)

    con *ValuePtr establecido en el argumento KeysetSize en SQLSetScrollOptions.

  • Una llamada a 

    SQLSetStmtAttr(StatementHandle, SQL_ROWSET_SIZE, ValuePtr, 0)

    con *ValuePtr establecido en el argumento RowsetSize en SQLSetScrollOptions.

    Nota

    Cuando el Administrador de controladores asigna SQLSetScrollOptions para una aplicación que trabaja con un controlador ODBC 3.x que no admite SQLSetScrollOptions, el Administrador de controladores establece la opción de instrucción SQL_ROWSET_SIZE, no el atributo de instrucción SQL_ATTR_ROW_ARRAY_SIZE, en el argumento RowsetSize de SQLSetScrollOption. Como resultado, una aplicación no puede usar SQLSetScrollOptions al capturar varias filas mediante una llamada a SQLFetch o SQLFetchScroll. Solo se puede usar al capturar varias filas mediante una llamada a SQLExtendedFetch.