Informazioni nelle interfacce di errore
Il provider OLE DB SQL Server Native Client segnala alcune informazioni sugli errori e sullo stato nelle interfacce di errore definite da OLE DB IErrorInfo, IErrorRecords e ISQLErrorInfo.
Il provider OLE DB SQL Server Native Client supporta le funzioni membro IErrorInfo come indicato di seguito.
| Funzione membro | Descrizione |
|---|---|
| GetDescription | Stringa descrittiva del messaggio di errore. |
| GetGUID | GUID dell'interfaccia che ha definito l'errore. |
| GetHelpContext | Non supportato. Restituisce sempre zero. |
| GetHelpFile | Non supportato. Viene restituito sempre NULL. |
| GetSource | Stringa "Microsoft SQL Server Native Client". |
Il provider OLE DB SQL Server Native Client supporta le funzioni membro IErrorRecords disponibili per il consumer come indicato 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 SQL Server Native Client non restituisce i parametri al consumer tramite GetErrorParameters. |
| GetRecordCount | Conteggio dei record di errore disponibili. |
Il provider OLE DB SQL Server Native Client supporta i parametri ISQLErrorInfo::GetSQLInfo come indicato 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 SQL Server Native Client 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 di inizializzazione di un'origine dati del provider OLE DB SQL Server Native Client. Prima del tentativo, il provider OLE DB SQL Server Native Client restituisce sempre zero. |