Nyomkövetési DLL

A nyomkövetést végző DLL az ODBC-alapösszetevők egyike. A nyomkövetési DLL jelenleg minta DLL-ként van megadva a Windows SDK ODBC-összetevőjében, és korábban a Microsoft Data Access Components (MDAC) SDK része volt. Ezért a nyomkövetési DLL beállításjegyzékbejegyzése, felülete és mintakódja elérhető. Ezt a DLL-t helyettesítheti egy ODBC-felhasználó vagy egy külső gyártó által előállított nyomkövetési DLL. Az egyéni nyomkövetési DLL-nek más nevet kell adni, mint az eredeti nyomkövetési DLL-minta. A nyomkövetési DLL-eket telepíteni kell a rendszerkönyvtárba, vagy nem fognak betöltődni. A kapcsolati sztringeket az Illesztőprogram-kezelő nem továbbítja a nyomkövetési DLL-nek.

A nyomkövetési DLL bemeneti argumentumokat, kimeneti argumentumokat, halasztott argumentumokat, visszatérési kódokat és SQLSTATE-ket követ nyomon. Ha a nyomkövetés engedélyezve van, az Illesztőprogram-kezelő két ponton hívja meg a nyomkövetési DLL-t: egyszer a függvénybejegyzéskor (az argumentum érvényesítése előtt), majd a függvény visszatérése előtt.

Amikor egy alkalmazás függvényt hív meg, az Illesztőprogram-kezelő meghív egy nyomkövetési függvényt a nyomkövetési DLL-ben, mielőtt meghívja a függvényt az illesztőprogramban, vagy feldolgozza magát a hívást. Minden ODBC-függvény rendelkezik egy ( Nyomkövetés előtaggal ellátott) nyomkövetési függvénnyel, amely a név kivételével megegyezik az ODBC függvénnyel. A nyomkövetési függvény meghívásakor a nyomkövetési DLL rögzíti a bemeneti argumentumokat, és visszaad egy visszatérési kódot. Mivel a nyomkövetési DLL-t a rendszer azelőtt hívja meg, hogy az Illesztőprogram-kezelő érvényesítené az argumentumokat, érvénytelen függvényhívások lesznek nyomon követve, így az állapotáttűnési hibák és az érvénytelen argumentumok naplózva lesznek.

Miután meghívta a nyomkövetési függvényt a nyomkövetési DLL-ben, az Illesztőprogram-kezelő meghívja az ODBC függvényt az illesztőprogramban. Ezután meghívja a TraceReturnt a nyomkövetési DLL-ben. Ez a függvény két argumentumot vesz fel: a nyomkövetési FÜGGVÉNY nyomkövetési DLL által visszaadott értékét, valamint az illesztő által az ODBC-függvény Illesztőprogram-kezelőjének visszaadott visszatérési kódot (vagy magát az illesztőprogram-kezelő által visszaadott értéket, ha feldolgozta a függvényt). A függvény a nyomkövetési függvény által visszaadott értéket használja a rögzített bemeneti argumentumértékek módosításához. Az ODBC függvényhez visszaadott kódot a naplófájlba írja (vagy dinamikusan jeleníti meg, ha ez engedélyezve van). Halasztja a kimeneti argumentum mutatóit, és naplózza a kimeneti argumentum értékeit.