Partilhar via


Mapeamento SQLSetScrollOptions

Quando um aplicativo chama SQLSetScrollOptions por meio de um driver ODBC 3.x e o driver não dá suporte a SQLSetScrollOptions, a chamada para

SQLSetScrollOptions(StatementHandle, Concurrency, KeysetSize, RowsetSize)  

resultará da seguinte maneira:

  • Uma chamada para

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

    com o argumento InfoType definido como um dos valores na tabela a seguir, dependendo do valor do argumento KeysetSize em 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
    Um valor maior que o argumento RowsetSize SQL_KEYSET_CURSOR_ATTRIBUTES2

    Se o valor do argumento KeysetSize não estiver listado na tabela anterior, a chamada para SQLSetScrollOptions retornará SQLSTATE S1107 (valor de linha fora do intervalo) e nenhuma das etapas a seguir será executada.

    Em seguida, o Gerenciador de Driver verifica se o bit apropriado está definido no valor *InfoValuePtr retornado pela chamada para SQLGetInfo, de acordo com o valor do argumento Concurrency em SQLSetScrollOptions.

    Argumento de simultaneidade Configuração 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

    Se o argumento Concurrency não for um dos valores na tabela anterior, a chamada para SQLSetScrollOptions retornará SQLSTATE S1108 (opção de simultaneidade fora do intervalo) e nenhuma das etapas a seguir será executada. Se o bit apropriado (conforme indicado na tabela anterior) não estiver definido em *InfoValuePtr como um dos valores correspondentes ao argumento Concurrency , a chamada para SQLSetScrollOptions retornará SQLSTATE S1C00 (Driver não compatível) e nenhuma das etapas a seguir será executada.

  • Uma chamada para

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CURSOR_TYPE, ValuePtr, 0)  
    

    com *ValuePtr definido como um dos valores na tabela a seguir, de acordo com o valor do argumento KeysetSize em 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
    Um valor maior que o argumento RowsetSize SQL_CURSOR_KEYSET_DRIVEN
  • Uma chamada para

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_CONCURRENCY, ValuePtr, 0)  
    

    com *ValuePtr definido como o argumento Concurrency em SQLSetScrollOptions.

  • Se o argumento KeysetSize na chamada para SQLSetScrollOptions for positivo, uma chamada para

    SQLSetStmtAttr(StatementHandle, SQL_ATTR_KEYSET_SIZE, ValuePtr, 0)  
    

    com *ValuePtr definido como o argumento KeysetSize em SQLSetScrollOptions.

  • Uma chamada para

    SQLSetStmtAttr(StatementHandle, SQL_ROWSET_SIZE, ValuePtr, 0)  
    

    com *ValuePtr definido como o argumento RowsetSize em SQLSetScrollOptions.

    Observação

    Quando o Gerenciador de Driver mapeia SQLSetScrollOptions para um aplicativo que trabalha com um driver ODBC 3.x que não dá suporte a SQLSetScrollOptions, o Gerenciador de Driver define a opção de instrução SQL_ROWSET_SIZE, não o atributo de instrução SQL_ATTR_ROW_ARRAY_SIZE, para o argumento RowsetSize em SQLSetScrollOption. Como resultado, SQLSetScrollOptions não pode ser usado por um aplicativo ao buscar várias linhas por uma chamada para SQLFetch ou SQLFetchScroll. Ele só pode ser usado ao buscar várias linhas por uma chamada para SQLExtendedFetch.