Compensações de vinculação de parâmetros

Uma aplicação pode especificar que um offset é adicionado aos endereços dos buffers de parâmetros vinculados e aos endereços correspondentes dos buffers de comprimento/indicador quando SQLExecDirect ou SQLExecute é chamado. O resultado destas adições determina os endereços usados nestas operações.

Os deslocamentos de ligação permitem a uma aplicação alterar ligações sem chamar SQLBindParameter para parâmetros previamente ligados. Uma chamada ao SQLBindParameter para reassociar um parâmetro altera o endereço do buffer e o ponteiro de comprimento/indicador. Rebinding com um offset, por outro lado, simplesmente adiciona um offset ao endereço do buffer de parâmetros vinculados existente e ao endereço do buffer de comprimento/indicador de comprimento existente. Quando são usados deslocamentos, as associações são um "modelo" de como os buffers da aplicação estão dispostos, e a aplicação pode mover esse "modelo" para diferentes áreas da memória ao alterar o deslocamento. Um novo deslocamento pode ser especificado a qualquer momento e é sempre adicionado aos valores originalmente limitados.

Para especificar um deslocamento de binding, a aplicação define o atributo da instrução SQL_ATTR_PARAM_BIND_OFFSET_PTR ao endereço de um buffer SQLINTEGER. Antes de a aplicação chamar uma função que usa as ligações, coloca um deslocamento em bytes nesse buffer, desde que nem o endereço do buffer de parâmetros nem o endereço do buffer de comprimento/indicador sejam 0, e o parâmetro limitado esteja na instrução SQL. A soma do endereço e do deslocamento deve ser um endereço válido. (Isto significa que um ou ambos, o deslocamento e o endereço ao qual o deslocamento é adicionado, podem ser inválidos, desde que a soma desses resulte num endereço válido.)

Observação

Os deslocamentos de ligação não são suportados por drivers ODBC 2.x.