Megosztás:


Eredmények lekérése (speciális)

Az alkalmazások megadhatják, hogy eltolás legyen hozzáadva a kötött adatpuffercímekhez, valamint a megfelelő hossz/mutató puffercímekhez az SQLBulkOperations, az SQLFetch, az SQLFetchScroll vagy az SQLSetPos meghívásakor. A hozzáadások eredményei határozzák meg az ezekben a műveletekben használt címeket.

A kötési eltolások lehetővé teszik az alkalmazás számára, hogy a kötéseket módosítsa anélkül, hogy meghívná az SQLBindCol funkciót a korábban kötött oszlopokra. Az SQLBindCol-nak az adatok újrakötésére irányuló hívása megváltoztatja a puffer címét és a hossz/mutató mutatót. Az eltolással való újrakötés viszont egyszerűen hozzáad egy eltolást a meglévő kötött adatpuffercímhez és a hossz/mutató puffercíméhez. Az eltolások használatakor a kötések az alkalmazáspufferek lefektetésének "sablonjai", és az eltolás módosításával az alkalmazás áthelyezheti ezt a "sablont" a memória különböző területeire. Egy új eltolás bármikor megadható, és mindig hozzá lesz adva az eredetileg kötött értékekhez.

Kötéseltolás megadásához az alkalmazás beállítja a SQL_ATTR_ROW_BIND_OFFSET_PTR utasítás attribútumot egy SQLINTEGER-puffer címére. Mielőtt az alkalmazás meghív egy olyan függvényt, amely a kötéseket használja( például SQLBulkOperations, SQLFetch, SQLFetchScroll vagy SQLSetPos), eltolást helyez el bájtokban ebben a pufferben, mindaddig, amíg sem az adatpuffer címe, sem a hossz/mutató puffercíme nem 0, és amíg a kötött oszlop az eredményhalmazban van. A cím és az eltolás összegének érvényes címnek kell lennie. (Ez azt jelenti, hogy az eltolás vagy a hozzáadott cím vagy mindkettő érvénytelen lehet, amíg az összegük érvényes címet eredményez.) Az SQL_ATTR_ROW_BIND_OFFSET_PTR utasítás attribútuma egy mutató, így az eltolás értéke több kötési adatkészletre is alkalmazható, és ezek mindegyike módosítható egyetlen eltolási érték megváltoztatásával. Az alkalmazásnak meg kell győződnie arról, hogy a mutató érvényes marad a kurzor bezárásáig.

Megjegyzés:

Az ODBC 2.x illesztőprogramok nem támogatják a kötéseltolásokat.

Ez a szakasz a következő témaköröket tartalmazza.