Offset di associazione di parametri

Un'applicazione può specificare che un offset viene aggiunto agli indirizzi del buffer dei parametri associati e agli indirizzi del buffer di lunghezza/indicatore corrispondenti quando viene chiamato SQLExecDirect o SQLExecute . Il risultato di queste aggiunte determina gli indirizzi usati in queste operazioni.

Gli offset di associazione consentono a un'applicazione di modificare le associazioni senza chiamare SQLBindParameter per i parametri associati in precedenza. Una chiamata a SQLBindParameter per riassociare un parametro modifica l'indirizzo del buffer e il puntatore di lunghezza/indicatore. La riassociazione con un offset, invece, aggiunge semplicemente un offset all'indirizzo del buffer dei parametri associati esistente e all'indirizzo del buffer di lunghezza/indicatore. Quando vengono usati gli offset, le associazioni sono un "modello" della disposizione dei buffer dell'applicazione e l'applicazione può spostare questo "modello" in aree di memoria diverse modificando l'offset. È possibile specificare un nuovo offset in qualsiasi momento e viene sempre aggiunto ai valori associati originariamente.

Per specificare un offset di associazione, l'applicazione imposta l'attributo dell'istruzione SQL_ATTR_PARAM_BIND_OFFSET_PTR sull'indirizzo di un buffer SQLINTEGER. Prima che l'applicazione chiami una funzione che usa le associazioni, inserisce un offset in byte in questo buffer, purché né l'indirizzo del buffer dei parametri né l'indirizzo del buffer di lunghezza/indicatore sia 0 e il parametro associato si trova nell'istruzione SQL. La somma dell'indirizzo e dell'offset deve essere un indirizzo valido. Ciò significa che sia l'offset che l'indirizzo a cui viene aggiunto l'offset non possono essere validi, purché la somma sia un indirizzo valido.

Annotazioni

Gli offset di associazione non sono supportati dai driver ODBC 2.x.