Informationen in Fehlerschnittstellen
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Der OLE DB-Treiber für SQL Server stellt einige Fehler- und Statusinformationen in den OLE DB-definierten Fehlerschnittstellen IErrorInfo, IErrorRecords und ISQLErrorInfo bereit.
Der OLE DB-Treiber für SQL Server unterstützt IErrorInfo-Elementfunktionen wie folgt.
Memberfunktion | BESCHREIBUNG |
---|---|
GetDescription | Beschreibende Fehlermeldungs-Zeichenfolge. |
GetGUID | GUID der Schnittstelle, die den Fehler definiert hat. |
GetHelpContext | Wird nicht unterstützt. Es wird immer NULL zurückgegeben. |
GetHelpFile | Wird nicht unterstützt. Gibt immer NULL zurück. |
GetSource | Zeichenfolge „Microsoft OLE DB-Treiber für SQL Server“. |
Der OLE DB-Treiber für SQL Server unterstützt für Consumer verfügbare IErrorRecords-Elementfunktionen wie folgt.
Memberfunktion | BESCHREIBUNG |
---|---|
GetBasicErrorInfo | Füllt eine ERRORINFO-Struktur mit grundlegenden Informationen über einen Fehler aus. Eine ERRORINFO-Struktur enthält Elemente, die den HRESULT-Rückgabewert für den Fehler sowie den Anbieter und die Schnittstelle, für die der Fehler gilt, identifizieren. |
GetCustomErrorObject | Gibt einen Verweis auf die Schnittstellen ISQLErrorInfo, und ISQLServerErrorInfo zurück. |
GetErrorInfo | Gibt einen Verweis auf eine IErrorInfo-Schnittstelle zurück. |
GetErrorParameters | Der OLE DB-Treiber für SQL Server gibt keine Parameter über GetErrorParameters an den Consumer zurück. |
GetRecordCount | Anzahl der verfügbaren Fehlerdatensätze. |
Der OLE DB-Treiber für SQL Server unterstützt ISQLErrorInfo::GetSQLInfo-Parameter wie folgt.
Parameter | BESCHREIBUNG |
---|---|
pbstrSQLState | Gibt einen SQLSTATE-Wert für den Fehler zurück. SQLSTATE-Werte werden in SQL-92, ODBC und ISO SQL sowie der API-Spezifikation definiert. Weder SQL Server noch der OLE DB-Treiber für SQL Server definieren implementierungsabhängige SQLSTATE-Werte. |
plNativeError | Gibt die SQL Server-Fehlernummer von master.dbo.sysmessages zurück, sofern verfügbar. Nach einem erfolgreichen Versuch, eine Datenquelle für den OLE DB-Treiber für SQL Server zu initialisieren, sind native Fehler verfügbar. Vor dem Versuch gibt der OLE DB-Treiber für SQL Server immer 0 (null) zurück. |