Diagnostics

Functions in ODBC return diagnostic information in two ways. The return code indicates the overall success or failure of the function while diagnostic records provide detailed information about the function. At least one diagnostic record—the header record—is returned even if the function succeeds.

Diagnostic information is used at development time to catch programming errors such as invalid handles and syntax errors in hard-coded SQL statements. It is used at run time to catch run-time errors and warnings such as data truncation, access violations, and syntax errors in SQL statements entered by the user.