Parameterbindingsverschuivingen

Een toepassing kan opgeven dat er een offset wordt toegevoegd aan afhankelijke parameterbufferadressen en de bijbehorende lengte/indicatorbufferadressen wanneer SQLExecDirect of SQLExecute wordt aangeroepen. Het resultaat van deze toevoegingen bepaalt de adressen die in deze bewerkingen worden gebruikt.

Met bindcompensaties kan een applicatie bindingen wijzigen zonder SQLBindParameter te gebruiken voor parameters die eerder gebonden zijn. Een aanroep van SQLBindParameter om een parameter opnieuw te koppelen, verandert het bufferadres en de lengte/indicator aanwijzer. Rebinding met een offset voegt daarentegen een offset toe aan het bestaande adres van de gebonden parameterbuffer en het adres van de lengte- of indicatorbuffer. Wanneer offsets worden gebruikt, zijn de bindingen een 'sjabloon' van hoe de toepassingsbuffers worden ingedeeld en kan de toepassing deze sjabloon naar verschillende gebieden van het geheugen verplaatsen door de offset te wijzigen. Een nieuwe offset kan op elk gewenst moment worden opgegeven en wordt altijd toegevoegd aan de oorspronkelijk gebonden waarden.

Als u een bindingsoffset wilt opgeven, stelt de toepassing voor het statementattribuut SQL_ATTR_PARAM_BIND_OFFSET_PTR in op het adres van een SQLINTEGER-buffer. Voordat de toepassing een functie aanroept die gebruikmaakt van de bindingen, wordt er een offset in bytes in deze buffer geplaatst, zolang noch het adres van de parameterbuffer, noch het adres van de lengte-/indicatorbuffer 0 is en de gebonden parameter zich in de SQL-instructie bevindt. De som van het adres en de offset moet een geldig adres zijn. (Dit betekent dat zowel de offset als het adres waaraan de offset wordt toegevoegd, ongeldig kan zijn, zolang de som een geldig adres is.)