Exemple de diagnostic d’un pilote basé sur des fichiers

Un pilote basé sur des fichiers agit à la fois en tant que pilote ODBC et en tant que source de données. Il peut donc générer des erreurs et des avertissements en tant que composant dans une connexion ODBC et en tant que source de données. Étant donné qu’il s’agit également du composant qui interface avec le Gestionnaire de pilotes, il met en forme et retourne des arguments pour SQLGetDiagRec.

Par exemple, si un pilote Microsoft pour dBASE n’a pas pu allouer suffisamment de mémoire, il peut retourner les valeurs suivantes de SQLGetDiagRec :

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

Étant donné que cette erreur n’était pas liée à la source de données, le pilote ajoutait uniquement des préfixes au message de diagnostic du fournisseur ([Microsoft]) et du pilote ([ODBC dBASE Driver]).

Si le pilote n’a pas trouvé le fichier Employee.dbf, il peut renvoyer les valeurs suivantes de SQLGetDiagRec :

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

Étant donné que cette erreur était liée à la source de données, le pilote a ajouté le format de fichier de la source de données ([dBASE]) comme préfixe au message de diagnostic. Étant donné que le pilote s'interfaçait également avec une source de données, il a ajouté des préfixes au nom du fournisseur ([Microsoft]) et du pilote ([ODBC dBASE Driver]).