File-Based Illesztő diagnosztikai példája

A fájlalapú illesztőprogramok ODBC-illesztőprogramként és adatforrásként is szolgálnak. Ezért hiba- és figyelmeztetéseket generálhat mind az ODBC-kapcsolat összetevőjeként, mind adatforrásként. Mivel az illesztőprogram-kezelővel is ez az összetevő kapcsolódik, ez formázza és adja vissza az SQLGetDiagRec argumentumait.

Ha például a dBASE-hez készült Microsoft-illesztőprogram nem tudott elegendő memóriát lefoglalni, akkor az SQLGetDiagRec következő értékeit adja vissza:

SQLSTATE:         "HY001"  
Native Error:      42052  
Diagnostic Msg:   "[Microsoft][ODBC dBASE Driver]Unable to allocate sufficient memory."  

Mivel ez a hiba nem az adatforráshoz kapcsolódott, az illesztőprogram csak a szállító ([Microsoft]) és az illesztőprogram ([ODBC dBASE-illesztőprogram]) diagnosztikai üzenetéhez adott hozzá előtagokat.

Ha az illesztő nem találja az Employee.dbf fájlt, az SQLGetDiagRec következő értékeit adja vissza:

SQLSTATE:         "42S02"  
Native Error:      -1305  
Diagnostic Msg:   "[Microsoft][ODBC dBASE Driver][dBASE]No such table or object"  

Mivel ez a hiba az adatforráshoz kapcsolódott, az illesztőprogram hozzáadta az adatforrás fájlformátumát ([dBASE]) a diagnosztikai üzenet előtagjaként. Mivel az illesztőprogram az adatforráshoz csatlakozó összetevő is volt, előtagokat adott hozzá a szállítóhoz ([Microsoft]) és az illesztőprogramhoz ([ODBC dBASE-illesztőprogram]).