Informationen in Fehlerschnittstellen
Der SQL Server Native Client OLE DB-Anbieter stellt einige Fehler- und Statusinformationen in den OLE DB-definierten Fehlerschnittstellen IErrorInfo-, IErrorRecords und ISQLErrorInfo bereit.
Der SQL Server Native Client OLE DB-Anbieter unterstützt IErrorInfo-Elementfunktionen wie folgt.
Elementfunktion |
Beschreibung |
---|---|
GetDescription |
Beschreibende Fehlermeldungs-Zeichenfolge. |
GetGUID |
GUID der Schnittstelle, die den Fehler definiert hat. |
GetHelpContext |
Nicht unterstützt. Es wird immer NULL zurückgegeben. |
GetHelpFile |
Nicht unterstützt. Es wird immer NULL zurückgegeben. |
GetSource |
Zeichenfolge "Microsoft SQL Server Native Client". |
Der SQL Server Native Client OLE DB-Anbieter unterstützt für Consumer verfügbare IErrorRecords-Elementfunktionen wie folgt.
Elementfunktion |
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 SQL Server Native Client OLE DB-Anbieter gibt über GetErrorParameters keine Parameter an den Consumer zurück. |
GetRecordCount |
Anzahl der verfügbaren Fehlerdatensätze. |
Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter haben implementierungsabhängige SQLSTATE-Werte definiert. |
plNativeError |
Gibt die SQL Server-Fehlernummer von master.dbo.sysmessages zurück, sofern verfügbar. Systemeigene Fehler sind nach einem erfolgreichen Versuch zur Initialisierung einer SQL Server Native Client OLE DB-Anbieterdatenquelle verfügbar. Vor dem Versuch gibt der SQL Server Native Client OLE DB-Anbieter immer 0 (NULL) zurück. |