Trasovací knihovna DLL

Knihovna DLL, která provádí trasování, je jednou ze základních komponent ODBC. Trasovací knihovna DLL je v současné době poskytována jako ukázková knihovna DLL v komponentě ODBC sady Windows SDK a dříve byla součástí sady MICROSOFT Data Access Components (MDAC) SDK. Proto jsou k dispozici položky registru, rozhraní a vzorový kód pro trasovací knihovnu DLL. Tuto knihovnu DLL lze nahradit trasovací knihovnou DLL vytvořenou uživatelem ODBC nebo dodavatelem třetí strany. Vlastní sledovací knihovna DLL by měla mít jiný název než původní ukázková sledovací knihovna DLL. Trasovací knihovny DLL musí být nainstalovány v systémovém adresáři, jinak se jim nepodaří načíst. Připojovací řetězce nebudou předány trasovací knihovně DLL správcem ovladačů.

Trasovací knihovna DLL trasuje vstupní argumenty, výstupní argumenty, odložené argumenty, návratové kódy a funkce SQLSTATEs. Pokud je trasování povolené, Správce ovladačů volá trasovací knihovnu DLL ve dvou bodech: jednou po zadání funkce (před ověřením argumentu) a znovu těsně před vrácením funkce.

Když aplikace volá funkci, Správce ovladačů nejprve zavolá funkci trasování v trasovací knihovně DLL před voláním funkce v ovladači nebo samotným zpracováním volání. Každá funkce ODBC má odpovídající funkci trasování (s předponou Trace), která je shodná s funkcí ODBC s výjimkou názvu. Při zavolání funkce trasování zachytí knihovna DLL trasování vstupní argumenty a vrátí návratový kód. Vzhledem k tomu, že je trasovací knihovna DLL volána dříve, než Správce ovladačů ověří argumenty, jsou trasována neplatná volání funkcí, takže jsou zaznamenány chyby přechodu stavu a neplatné argumenty.

Po volání funkce trasování v knihovně DLL trasování volá Správce ovladačů funkci ODBC v ovladači. Potom volá TraceReturn v trasovací knihovně DLL. Tato funkce má dva argumenty: hodnotu vrácenou trasovací knihovnou DLL pro funkci trasování a návratový kód vrácený ovladačem pro funkci ODBC (nebo hodnotu vrácenou správcem ovladačů, pokud zpracovává funkci). Funkce používá hodnotu vrácenou trasovací funkci k manipulaci se zachycenými hodnotami vstupních argumentů. Zapíše kód vrácený pro funkci ODBC do souboru protokolu (nebo ho dynamicky zobrazí, pokud je tato funkce povolená). Přehodnocuje ukazatele výstupních argumentů a protokoluje hodnoty výstupních argumentů.