Informazioni nelle interfacce di errore
Il provider OLE DB di SQL Server Native Client segnala informazioni sullo stato e sugli errori nelle interfacce di errore definite da OLE DB IErrorInfo, IErrorRecords e ISQLErrorInfo.
Il provider OLE DB di SQL Server Native Client supporta le funzioni membro di IErrorInfo come illustrato di seguito.
Funzione membro |
Descrizione |
|---|---|
GetDescription |
Stringa descrittiva del messaggio di errore. |
GetGUID |
GUID dell'interfaccia che ha definito l'errore. |
GetHelpContext |
Non supportata. Restituisce sempre zero. |
GetHelpFile |
Non supportata. Restituisce sempre NULL. |
GetSource |
Stringa "Microsoft SQL Server Native Client". |
Il provider OLE DB di SQL Server Native Client supporta funzioni membro di IErrorRecords disponibili per il consumer, come illustrato di seguito.
Funzione membro |
Descrizione |
|---|---|
GetBasicErrorInfo |
Inserisce in una struttura ERRORINFO le informazioni di base su un errore. Una struttura ERRORINFO contiene membri che identificano il valore restituito HRESULT per l'errore nonché il provider e l'interfaccia alle quali si applica l'errore. |
GetCustomErrorObject |
Restituisce un riferimento nelle interfacce ISQLErrorInfo e ISQLServerErrorInfo. |
GetErrorInfo |
Restituisce un riferimento in un'interfaccia IErrorInfo. |
GetErrorParameters |
Il provider OLE DB di SQL Server Native Client non restituisce parametri al consumer tramite GetErrorParameters. |
GetRecordCount |
Conteggio dei record di errore disponibili. |
Il provider OLE DB di SQL Server Native Client supporta i parametri ISQLErrorInfo::GetSQLInfo come illustrato di seguito.
Parametro |
Descrizione |
|---|---|
pbstrSQLState |
Restituisce un valore SQLSTATE per l'errore. I valori SQLSTATE vengono definiti nelle specifiche API, SQL-92, ODBC e ISO SQL. Né SQL Server, né il provider OLE DB di SQL Server Native Client definisce valori SQLSTATE specifici dell'implementazione. |
plNativeError |
Restituisce il numero di errore di SQL Server da master.dbo.sysmessages, quando disponibile. Gli errori nativi sono disponibili dopo un tentativo riuscito di inizializzare un'origine dati del provider OLE DB di SQL Server Native Client. Prima del tentativo il provider OLE DB di SQL Server Native Client restituisce sempre zero. |