Deslocamentos de associação de parâmetro

Um aplicativo pode especificar que um deslocamento é adicionado aos endereços de buffer de parâmetro delimitados e aos endereços de buffer correspondentes de tamanho/indicador quando SQLExecDirect ou SQLExecute é chamado. O resultado dessas adições determina os endereços usados nessas operações.

Os offsets de associação permitem que um aplicativo altere as associações sem chamar SQLBindParameter para parâmetros associados anteriormente. Uma chamada para SQLBindParameter para reassociar um parâmetro altera o endereço do buffer e o ponteiro de comprimento/indicador. A reassociação com um deslocamento, por outro lado, simplesmente adiciona um deslocamento ao endereço já existente do buffer de parâmetros e ao endereço do buffer de comprimento ou indicador. Quando os deslocamentos são utilizados, as associações atuam como um "modelo" que descreve a disposição dos buffers do aplicativo. O aplicativo pode transferir esse "modelo" para diferentes áreas de memória ao alterar o deslocamento. Um novo deslocamento pode ser especificado a qualquer momento e sempre é adicionado aos valores vinculados originalmente.

Para especificar um offset de ligação, o aplicativo configura o atributo de declaração SQL_ATTR_PARAM_BIND_OFFSET_PTR para o endereço de um buffer SQLINTEGER. Antes que o aplicativo chame uma função que usa as associações, ele 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 seja 0, e que o parâmetro vinculado esteja presente na instrução SQL. A soma do endereço e do deslocamento deve ser um endereço válido. (Isso significa que tanto o deslocamento quanto o endereço ao qual o deslocamento é adicionado podem ser inválidos, desde que a soma seja um endereço válido.)

Observação

Não há suporte para deslocamentos de associação pelo ODBC 2. x drivers.