Freigeben über

Informationen in Fehlerschnittstellen

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

OLE DB-Treiber herunterladen

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.

Weitere Informationen

Fehler