Spåra DLL

Den DLL som utför spårning är en av ODBC-kärnkomponenterna. Spårnings-DLL:n tillhandahålls för närvarande som ett exempel på DLL i ODBC-komponenten i Windows SDK och inkluderades tidigare i SDK:n för Microsoft Data Access Components (MDAC). Därför är registerposten, gränssnittet och exempelkoden för spårnings-DLL tillgängliga. Denna DLL kan ersättas av en spårnings-DLL som skapats av en ODBC-användare eller en tredjepartsleverantör. En anpassad spårnings-DLL bör ges ett annat namn än den ursprungliga exempelspårnings-DLL:en. Spårnings-DLL:er måste installeras i systemkatalogen, annars kan de inte läsas in. Anslutningssträngarna skickas inte till spårnings-DLL:en av drivrutinshanteraren.

Spårnings-DLL spårar indataargument, utdataargument, uppskjutna argument, returkoder och SQLSTATEs. När spårning är aktiverat anropar Driver Manager spårnings-DLL:en vid två punkter: en gång vid funktionsposten (före argumentvalidering) och igen precis innan funktionen returneras.

När ett program anropar en funktion anropar Driver Manager en spårningsfunktion i spårnings-DLL innan du anropar funktionen i drivrutinen eller bearbetar själva anropet. Varje ODBC-funktion har en motsvarande spårningsfunktion ( prefixet trace) som är identisk med ODBC-funktionen med undantag för namnet. När spårningsfunktionen anropas samlar spårnings-DLL:en indataargumenten och returnerar en returkod. Eftersom spårnings-DLL anropas innan Driver Manager validerar argument spåras ogiltiga funktionsanrop, så tillståndsövergångsfel och ogiltiga argument loggas.

När du har anropat spårningsfunktionen i spårnings-DLL anropar Driver Manager ODBC-funktionen i drivrutinen. Den anropar sedan TraceReturn i spårnings-DLL:en. Den här funktionen tar två argument: värdet som returneras av spårnings-DLL för spårningsfunktionen och returkoden som returneras av drivrutinen till Driver Manager för ODBC-funktionen (eller värdet som returneras av driverhanteraren själv om den bearbetade funktionen). Funktionen använder värdet som returneras för spårningsfunktionen för att manipulera insamlade indataargumentvärden. Den skriver koden som returneras för ODBC-funktionen till loggfilen (eller visar den dynamiskt, om den är aktiverad). Den avrefererar utdataargumentpekarna och loggar utdataargumentvärdena.